Connect your agent

Your agent runs on your own machine, on your own account with your AI provider. Gaitro gives it two ways in: the gaitro CLI, which every agent can run, and an MCP server (gaitro mcp) that hands MCP-capable agents typed tools and pushes events to them.

Install the CLI and log in first (Get started). Then:

Claude Code

claude mcp add --scope user gaitro -- gaitro mcp

--scope user makes it available in every project on this machine. Claude Code reads CLAUDE.md, which points at GAITRO.md.

Codex

codex mcp add gaitro -- gaitro mcp

Codex reads AGENTS.md, which points at GAITRO.md.

Cursor

Add the server to ~/.cursor/mcp.json (or .cursor/mcp.json in one project):

{
  "mcpServers": {
    "gaitro": { "command": "gaitro", "args": ["mcp"] }
  }
}

Anything else

Any agent that can run commands can use the CLI directly. Every command takes --json, and a blocked claim exits with code 3 and lists the options. Point the agent at GAITRO.md in the project; it says everything in The workflow.

Revoking a computer

Each login is named after the machine it was approved on. Revoke it under the company's Settings › Agents, and that machine's agents stop at once.