Quickstart

Every path below ends in the same place: an agent you own, a session you can resume, and a streamed reply. Pick the one that matches how you like to work.

Install

npm install -g @agent-commons/cli

Sign in

agc login

agc starts an OAuth device flow: it prints a URL and a one-time code, opens your browser, and waits for you to approve. Credentials land in ~/.agc/config.json (mode 0600) and refresh themselves.

For CI, skip the browser and use a project key instead:

agc login --api-key csk_live_xxx

Create an agent

agc agents create \
  --name "Research Bot" \
  --instructions "You research topics and answer with sources." \
  --provider anthropic \
  --model claude-sonnet-4-6

Talk to it

agc chat --agent <agentId>

Tokens stream as they arrive and tool calls appear inline. agc chat also exposes your working directory to the agent as local tools, so it can read and write files on your machine — add --no-local to turn that off, or --computer to give it a cloud box instead.

One-shot instead of a REPL:

agc run --agent <agentId> "Summarise this week's AI policy news"

Run agc with no arguments for an interactive menu of everything else. Full command list: CLI reference.

Next

Core concepts

Authentication

Give it tools

Put it on a schedule

On this page