configs
Save, load, list, and restore named configurations and automatic backups.
configs manages full snapshots of your .claude, .codex, and .agents
folders. Saved configs and backups include sessions, projects, logs, caches,
and every other file inside those folders so switching configs does not discard
history.
Named configs
| Command | Description |
|---|---|
configs save <name> | Save the current folders as a named config. |
configs load <name> | Load a named config (current folders are backed up first). |
configs list | List all saved named configs. |
configs undo | Undo the most recent load using the automatic backup. |
Save
# Save a snapshot
npx aiblueprint-cli@latest configs save work
# Overwrite an existing snapshot
npx aiblueprint-cli@latest configs save work --force
Load and undo
npx aiblueprint-cli@latest configs load work
npx aiblueprint-cli@latest configs undo
Loading always backs up your current configuration first, so configs undo
can roll back the change.
Automatic backups
The CLI snapshots your configuration automatically before setup and sync. Manage
those snapshots with the backups subcommands:
| Command | Description |
|---|---|
configs backups list | List automatic backups with their reasons. |
configs backups load <name> | Load a backup (current folders are backed up first). |
configs backups create [reason] | Create a manual backup with an optional reason. |
configs backups clean | Delete automatic backups older than the retention window. |
npx aiblueprint-cli@latest configs backups list
npx aiblueprint-cli@latest configs backups create "before experiment"
npx aiblueprint-cli@latest configs backups load 2026-05-28-setup
npx aiblueprint-cli@latest configs backups clean --days 30
npx aiblueprint-cli@latest configs backups clean --days 30 --dry-run
npx aiblueprint-cli@latest configs backups clean --days 90 --include-manual
Each entry shows its name, date, reason, trigger, the folders included, and its
path on disk. configs backups clean deletes retention-managed backups older
than 30 days by default. Manual backups created with configs backups create
are kept unless you pass --include-manual. Use --days to change the
retention window and --dry-run to preview what would be removed.
Session recovery
If you have sessions spread across saved configs and backups, merge them back into the current folders without overwriting existing files:
npx aiblueprint-cli@latest agents config unify sessions
Identical session files are skipped. If the same session path exists with different content, the imported file is copied with a source suffix.