The simple CLI (@simple-ai-lab/cli) moves agents between production and a TypeScript repository. You define an agent in code with the SDK; the CLI pulls it from production, shows what you changed, and publishes it back.
Install
npm install -g, yarn global add, and bun add -g work too. pnpm 10 may warn that it ignored esbuild’s build script; the CLI works without it, so there is nothing to approve.
The CLI needs Node.js 20 or later and a Simple AI account that belongs to at least one organization. Agent projects use pnpm to install dependencies and typecheck; simple typecheck runs npm, yarn, or bun instead when the project’s package.json names one of them as its packageManager.
Authentication
login opens your browser and signs you in with the same account you use for the dashboard. When you belong to more than one organization, it asks which one to use. The session is saved, so you sign in once and every later command uses it. whoami confirms who you are signed in as and which organization the session is on. When you are done, simple logout ends the session and removes the saved credentials.
The CLI never takes an API key. Every command runs with your own permissions.
Start a Project
There are two ways to start. For a new agent, simple init creates a starter project:
For an agent that already exists in production, simple pull writes it into a new directory. The agent’s UUID is shown on its page in the dashboard:
Either way the project has agent.ts, a package.json and tsconfig.json, and simple.lock.json, which the CLI uses to track what the project was last synchronized with. A pulled agent also has its Code Action handlers under actions/ and its prompts under prompts/. Check all of it into source control except node_modules.
Edit, Diff, Publish
Edit agent.ts, the handlers, or the prompts, then run the three commands that make up the loop:
Publish validates the whole project on the server first, and refuses to overwrite changes made in production since your last pull.
Next Steps
- Agent projects: what
pull writes, what the lock file records, and how publish keeps code and production in step.
- CLI reference: every command you will use, with its flags.
- Agents as code: the
defineAgent API, Actions, and organization resources.
Last modified on October 30, 2026
