axsDocs
Getting started

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 cursor

Each 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.

FlagEffect
--no-brainLeaves out axs brain (hooks and MCP server)
--no-buildLeaves 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@axs

See 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.sh

Replace 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 codex

On 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.

On this page