Connect your agents
Add axs to Claude Code, Codex and Cursor with one command.
After axs login, run one line per agent:
axs install claude
axs install codex
axs install cursorEach agent gets its own device token, made from your axs login, so logging out of one never logs out another. Every file it changes gets a backup first.
| Flag | Effect |
|---|---|
--no-brain | Leaves out axs brain (hooks and MCP server) |
--no-build | Leaves out the axs build route hook |
axs uninstall claude|codex|cursor takes only the axs entries out again.
Claude Code
axs install claude installs the axs plugin (axs@axs) from the marketplace axs-sh/claude: axs brain and
axs build in one plugin. It replaces brain@axs if that is installed (its login stays), so no hook runs twice. The
plugin gets its own token from your axs login, so Claude Code needs no browser login. Start a new session.
Without the CLI, install only axs brain with the plugin brain@axs:
claude plugin marketplace add axs-sh/claude; claude plugin install brain@axsSee The plugin.
Codex
axs install codex adds the axs brain hooks to ~/.codex/hooks.json, the MCP server to ~/.codex/config.toml (or
$CODEX_HOME) and the axs build route hook. The token goes into a file only you can read
(~/.config/axs-brain/codex.json), never into the Codex config.
Then start Codex, type /hooks and trust the axs brain hooks. Codex skips new hooks until you trust them.
Cursor
axs install cursor adds the hooks to ~/.cursor/hooks.json, the MCP server to ~/.cursor/mcp.json and the axs
build route hook. The token goes into ~/.config/axs-brain/cursor.json.
Then in Cursor open Settings, Tools & MCP, click Connect next to axs brain and sign in.
Without the axs CLI
The dashboard (Connect a tool) also shows a line that sets up axs brain for Codex or Cursor without the CLI
(macOS and Linux). It downloads the small helper axs-brain and opens the browser to approve the device:
curl -fsSL https://raw.githubusercontent.com/axs-sh/claude/main/install.sh | sh -s -- codex https://brain.axs.shReplace codex with cursor for Cursor. For a script, set BRAIN_TOKEN to a device token from the dashboard
instead. To remove it:
~/.config/axs-brain/bin/axs-brain uninstall codexOn macOS the helper is in ~/Library/Application Support/axs-brain/bin/.
Devices
Every connected agent shows up under Team settings, Devices in the dashboard. Sign one out there to end its
token.