@acentric/cli

The acentric command. It makes a project, runs it on your machine with a prompt to talk to the agent, deploys it to a server, and operates its actors from a terminal or from CI.

npx @acentric/cli init my-agent
cd my-agent
npm run dev

init asks the project's name, the model's provider and its key, which it keeps in .env. The project holds acentric.json, the agent in src/agent.ts, and @acentric/agent and @acentric/cli at this CLI's version. acentric dev runs the agent locally, redeploys it on save, and talks to it. Node 22.19 or newer runs the dev server.

npx acentric login
npm run deploy
npx acentric secrets set ANTHROPIC_API_KEY --from-env
npx acentric send hello "plan a launch"

| Command | Does | | --------------------------------------------------- | -------------------------------------------------------------------------------- | | init [dir] | Makes a project | | dev | Runs the project locally, redeploys on save, and talks to the agent | | deploy [file] | Bundles the agent and deploys it as the next version | | send <actor> [text] | Sends an event, creating the actor if it is new, and shows the run until it ends | | log <actor> | Reads an actor's log; -f follows it | | state <actor> | An actor's state; --seq <n> as it was then, --changes how it changed | | ls [agent], show <actor>, agents | Lists and shows actors and agents | | abort <actor>, terminate <actor> | Ends the run going on; ends the actor | | secrets set <NAME>, secrets ls, secrets rm | The agent's secrets on the server | | open [actor] | Prints the dashboard's page for the agent or the actor | | login, logout, whoami | Signing in | | orgs ls, orgs create <name>, orgs use <org> | Orgs | | keys ls, keys create <name>, keys revoke <id> | The org's API keys |

send takes --at <time> or --in <duration> to schedule the event for later, and acentric dev draws a scheduled event's run when it comes due. acentric <command> --help lists a command's flags. The server is the platform, https://api.acentric.dev, unless --api <url>, ACENTRIC_API or api in acentric.json names another; --local is this project's acentric dev. CI uses an API key in ACENTRIC_API_KEY. Logins are kept in ~/.config/acentric/credentials.json.