Back to Docs
Offline Mode
How claudeBase CLI operates without network connectivity.
Enabling Offline Mode
$ claudebase plugin add code-review --offline
When --offline is set, the CLI will never attempt network calls. All data must come from cache.
What Gets Cached
Catalog Cache
~/.claudebase/cache/catalog/
Catalog index, snapshots, and monotonic tracking.
Tarball Cache
~/.claudebase/cache/tarballs/
Downloaded npm package tarballs.
Command Network Behavior
| Command | Normal | --offline |
|---|---|---|
| catalog refresh | Network | Error |
| catalog status | Never | OK |
| plugin add | Conditional* | Cache only |
| plugin list | Never | OK |
| plugin remove | Never | OK |
*One-shot refresh on miss or --refresh-catalog flag
Preparing for Offline Work
# While online, refresh catalog
$ claudebase catalog refresh
# Install plugins you'll need (caches tarballs)
$ claudebase plugin add code-review
$ claudebase plugin add test-generator
# Later, install offline using cache
$ claudebase plugin add code-review --offline
✓ Installed from cache
Common Offline Errors
- No cached catalog - Run
catalog refreshwhile online - Plugin not in cache - Install the plugin once while online to cache tarball
- Network forbidden - Remove --offline flag or use cached data