Use the Attio CLI with your AI agent
Read and change deals, see the pipeline, find people and companies live and call the Attio API.
Find a deal, see your pipeline or what changed overnight with one short command, the same one your agent runs. Attio's
API speaks in record ids, attribute slugs and status ids, and attio takes stage names and plain words instead.
You find the deals in a stage, the week's wins or a person's e-mail in one line. An agent does the same from your request.
Every command starts with a profile, the name you gave one workspace's sign-in. sync copies your deals and the people
and companies they name into the WireCat local store, where the deal commands read them. You need a signed-in profile:
install sets one up.
On this page:
- The profile comes first
- Sync
- Deals
- The pipeline
- What changed
- People, companies and members
- Your own attributes
- Search everything
- The Attio API
- Output for scripts
- Agents
The profile comes first
A profile is a name you choose for one workspace. It is the first word of every command that uses an account:
attio work config showWCATTIO_PROFILE=work does the same for one shell session. No profile is ever assumed, not even the only one: a
command without one stops with exit code 2 and lists the profiles on this computer. Two workspaces are two profiles,
each with its own token.
Sync
Deals, the pipeline and its stages are read from the local WireCat store, the one every WireCat tool searches. sync
brings it up to date:
attio work sync # every deal and the people and companies it names, again
attio work sync --rescan # start over, dropping a sync that stopped half way
attio work store status # how far each kind is, and how many are storedAttio cannot list only the records changed since a time, so each sync reads every deal again, then the people and
companies they name. A sync stops
before its deadline or --max-pages, and the next one goes on from there. Records deleted in Attio leave the copy.
Each record keeps its current values only. Attio keeps the history of each attribute, and a value that was replaced is not copied.
Deals
attio work deals list status:open # open, won or lost
attio work deals list stage:"In Progress"
attio work deals list "created>=30d" # made in the last 30 days
attio work deals show deal:12 # by the ref a list prints
attio work deals list status:open --format csv > deals.csvA deal answers its stage, status, amount with its currency, its company, its people, its owner and a link to
the deal in Attio. --offline reads the same, with no request to Attio. A list shows the newest first: --limit and
--page change that. The fields a list can filter by are in its help: attio help deals list.
Attio has one deal pipeline. Its stages are the statuses of the deal's Stage attribute, in Attio's order:
- Won is the stage Attio celebrates when a deal reaches it.
- Lost is a stage whose title starts with "Lost", as in a new Attio workspace.
- Every other stage is open.
If you renamed your lost stage to something else, its deals count as open. Keep "Lost" at the start of its title.
The pipeline
attio work pipelines show # each stage: how many, their sum per currency, how many went on
attio work pipelines show --since-time 30d # only the deals made in the last 30 days, with the win rate
attio work stages list # each stage with its outcome and how many are open in itThe pipeline is named Deals. Sums are kept per currency and never converted.
What changed
changes list shows what the syncs saw change in the copy: deals created, moved, won, lost and given another owner,
newest first. It reads the last day unless at: says otherwise.
attio work changes list "at>=1d"
attio work changes list change:won "at>=7d" --json
attio work changes list "at>=1d" --format report # the window as a short morning digestA change is seen only by a sync, so run sync first.
People, companies and members
People, companies and workspace members are read from Attio each time, so they need the internet and --offline
refuses them. Words after list search Attio: people by name or e-mail, companies by name.
attio work people list anna # people whose name or e-mail holds "anna"
attio work people show "Anna Example" # one person by exact name or id, with e-mails and phones
attio work organizations list example # companies whose name holds "example"
attio work organizations list --format csv > companies.csv
attio work users list # your workspace members, the owners of dealsA live list takes words only, not field:value terms. With no words it lists everyone, newest first. A person or a
company gives your workspace's own attributes under provider_metadata.
Your own attributes
attio work fields list deals
attio work fields list people --jsonfields list shows the attributes your workspace added on deals, people or companies (organizations), with their
type, as the last sync stored them. A select attribute's options are not listed yet. Attio's own attributes are left out.
Search everything
attio work search all "Example LLC"
attio work search all renewal --only crmsearch all searches the deals in the copy by the words of their title, company and people, and the messages, notes,
calendar events and meetings that other WireCat tools stored on this computer. The best match comes first.
The Attio API
attio work api runs any operation of the Attio API, one command each, with its own flags and help. It reaches what
has no command of its own yet: notes, tasks, lists, custom objects, meetings and more.
attio work api list # every operation, without calling Attio
attio work api show objects-records-query # one operation's parameters
attio work api objects-list # the objects in your workspaceEach operation has its own permission key, such as api.notes-create. Writes go through only as far as the token's
scopes allow: with the three read scopes from install, Attio refuses them. To keep every write
out of reach on this computer, set attio work config set permissions.api readonly. See
permissions.
Output for scripts
Every command except mcp serve on stdin and stdout takes --json, and prints one JSON value on stdout. Errors are
JSON on stderr, with a code to branch on. --format csv turns a list page into a table. The
command reference lists the exit codes.
Agents
attio skill install puts the tool's skill where Claude Code, Codex, Gemini CLI and OpenClaw look for it.
attio skill install --for hermes also adds that folder to Hermes Agent's own settings, so a bare skill install
leaves Hermes out.
An agent with a terminal then runs attio itself. Ask in plain words:
"Use attio. Which deals moved yesterday, and which are still open in Negotiation?" "Use attio. Export our open deals to a CSV file." "Use attio. Who is our contact at Example LLC, and what deals do we have with them?"
For Claude Desktop, Cursor, ChatGPT and other apps that cannot run commands, attio work mcp serve serves the same
commands over MCP. Lock the api group's writes first: over MCP a write at ask goes ahead. See MCP.