aam-cli
v0.1.0
Published
Agent Asset Management CLI — backup, restore, sync your Claude/CodeBuddy/Cursor agents/MCPs/skills/memory across machines
Maintainers
Readme
aam-cli
CLI for Aamira (Agent Asset Management) — backup, restore, sync your Claude / CodeBuddy / Cursor agents · MCPs · skills · memory across machines.
Install
npm install -g aam-cli@betaVerify:
aam --versionQuick start
# 1. Login (email + 6-digit OTP)
aam login --email [email protected]
# 2. Scan local IDE configs and upload everything
aam backup
# 3. On a different machine, restore everything
aam login --email [email protected]
aam restore --ide claude
# 4. Migrate your Claude assets to Cursor
aam migrate claude cursorCommands
| Command | Description |
|---|---|
| aam login | Email magic-link or OTP login |
| aam logout | Clear local credentials |
| aam whoami | Show current user + device + API base |
| aam backup | Scan local IDEs, upload all agents/MCPs/skills/memory |
| aam restore | Download cloud assets to local IDE |
| aam sync | Two-way sync (local + cloud) |
| aam migrate <from> <to> | Migrate assets between IDEs |
| aam export -o <dir> | Export all cloud assets to JSON files |
| aam record "<text>" | Manually record a memory entry |
Run aam <command> --help for detailed options.
Supported IDEs
- Claude Code (
~/.claude/) — agents, MCPs, skills, memory - CodeBuddy (
~/.codebuddy/) — agents, MCPs, skills, memory - Cursor (
~/.cursor/) — agents (rules), MCPs, memory (no skill support)
Asset types
agent_config— agent definitions (system prompts, tool configs)mcp— MCP server configs (command + args + env)skill— skill packages (markdown + scripts directory)memory— long-term context (markdown / facts) — industry first
Storage
- Assets ≤ 512KB are stored inline in DB (fast queries)
- Larger payloads (e.g. skill bundles) automatically use cloud object storage
- Every change creates a new version — full history retained
Privacy
- All data is encrypted in transit (HTTPS)
- Memory assets will support end-to-end encryption (M0.5+)
- Your assets are private by default; explicitly mark
visibility: publicto share via Hub (M0.5+)
Development
git clone https://github.com/WanfengzzZ/aam-cli.git
cd aam-cli
pnpm install
pnpm dev login --email [email protected] # run from source
pnpm test # 24 tests
pnpm build # → dist/cli.mjsLicense
MIT © WanfengzzZ
Links
- 🌐 Web: https://aam.dev
- 📚 Docs: https://aam.dev/docs
- 🐛 Issues: https://github.com/WanfengzzZ/aam-cli/issues
- 💬 Feedback: [email protected]
