Maintenance & Troubleshooting
This section covers commands that are not directly related to daily development but come in handy from time to time: upgrading the CLI, viewing command history, installing Agent Skills, and migrating from the legacy scaffold.
Upgrading the CLI Itself
rabetbase update run
You can also check the help output first to confirm the current behavior. After upgrading, it's a good idea to run rabetbase doctor check to make sure the PATH and cache are not still pointing to the old binary.
Diagnosing Environment and Login: doctor
rabetbase doctor
This checks your configuration, login state, connectivity, and more (specific checks may vary). Run this first when you encounter login or network issues -- it's faster than repeatedly trying api pull to track down the problem.
Command History: logs
The CLI can record previously executed commands so you can recall what you typed:
rabetbase logs show
Running rabetbase logs without a subcommand is equivalent to show.
To clear the history:
rabetbase logs clear
Whether sensitive information is logged depends on the implementation version. Do not treat log files as a secure storage mechanism; use environment variables or a secret manager for important tokens.
Installing Developer Skills: skill install
To install the official Lovrabet Skill package for use in AI editors:
rabetbase skill install
This runs an npx skills-based flow where you can choose your IDE. The old alias rabetbase skills is deprecated; use the command above instead.
Migrating from lovrabet-cli to rabetbase-cli: project upgrade
For legacy projects that still have old configurations, old Skills, or old MCP entries:
rabetbase project upgrade
This analyzes first, then asks whether to proceed. To skip the prompt:
rabetbase project upgrade --yes
Commit or back up your repository before running the migration. The upgrade handles config file renaming, cleaning up obsolete MCP configurations, and more. For details, refer to the command-line interaction and documentation.
Where to Look for Common Issues
| Symptom | Suggestion |
|---|---|
| Not logged in / 401 errors | See Quick Start then re-run auth login |
| Wrong data, seems connected to the wrong database | Check appcode, env, and --app in Configuration |
| Scripts won't run | See Daily Development then use rabetbase run |
| Can't remember flags or environment variables | See Command Reference |
Summary
update run: Upgrade the CLI.doctor check: Diagnose before troubleshooting.logs: Review what you've run.skill install: Install AI Skills.project upgrade: Migration path for legacy users.
Back to the tutorial index: Introduction.