CLI
The amodal CLI is the primary interface for building, running, and testing agents. Install it globally or use via npx:
npm install -g @amodalai/amodal
# or
npx amodal <command>Commands
Project
| Command | Description |
|---|---|
init | Scaffold a new agent project |
dev | Start local dev server with hot reload |
validate | Check config and test live connections (--skip-test to disable) |
inspect | Show compiled context with token counts |
build-manifest-types | Generate TypeScript types from manifest |
Packages (amodal pkg)
| Command | Description |
|---|---|
pkg connect | Add a connection (plugin or custom) |
pkg sync | Sync API specs from remote sources |
pkg install | Install marketplace packages |
pkg uninstall | Remove packages |
pkg list | List installed items |
pkg update | Update packages |
pkg diff | Show package changes |
pkg search | Search the marketplace |
pkg publish | Publish to the registry |
pkg link | Link a local package for development |
Deploy (amodal deploy)
| Command | Description |
|---|---|
deploy push | Deploy to the platform |
deploy build | Build a deployment snapshot |
deploy serve | Run from a snapshot file |
deploy status | Show deployment status |
deploy list | List deployments |
deploy rollback | Roll back to a previous deployment |
deploy promote | Promote a deployment |
Runtime
| Command | Description |
|---|---|
chat | Interactive terminal chat with your agent |
test-query | Fire a one-off query against the agent |
Testing & Evaluation
| Command | Description |
|---|---|
eval | Run evaluation suites |
test-query | Test a single query |
Ops (amodal ops)
| Command | Description |
|---|---|
ops secrets | Manage secrets |
ops docker | Docker image management |
ops automations | Manage automations |
ops audit | View audit logs |
ops experiment | Compare models, prompts, or configs |
Auth (amodal auth)
| Command | Description |
|---|---|
auth login | Log in to the platform |
auth logout | Log out |