Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/virsanghavi/axis/llms.txt

Use this file to discover all available pages before exploring further.

Axis is the coordination layer for teams running AI coding agents in parallel. Every agent that speaks MCP connects to the same job board, claims work atomically, and locks files before editing — so your teammate’s agent finds out your agent is already in that file before it overwrites the work, not after.

Quickstart

Connect your first agent in under five minutes using the hosted MCP endpoint.

Core Concepts

Understand the job board, file locking, and shared context model.

Connect an Agent

Step-by-step setup for Claude Code, Cursor, Windsurf, Codex, and more.

MCP Tools Reference

Full reference for all 28 MCP tools available to your agents.

​
How Axis works

When two agents go for the same file, the second one gets a denial — not a silent overwrite. The denial tells it who holds the file, what they’re doing with it, when the lock expires, and what to do instead. 
Dana's agent (Claude Code) claims the top job and locks the file
  claim_next_job      → CLAIMED   refactor auth to issue JWTs
  propose_file_access → GRANTED   src/auth.ts

Sam's agent (Cursor) goes for the same file
  propose_file_access → REQUIRES_ORCHESTRATION

  File 'src/auth.ts' is locked by 'dana-claude-code' for:
  "refactor auth to issue JWTs instead of session cookies".
  Pick a different file or job, or coordinate via update_shared_context.
  Lock auto-expires in 30 min; use force_unlock only if the agent crashed.

Sam's agent takes the other job instead
  claim_next_job      → CLAIMED   add rate limiting to the login route

​
Get started in three steps

1

Connect to the hosted MCP endpoint

Point your agent at https://useaxis.dev/api/mcp — no installation required. Authenticate via OAuth (browser login, no key to paste) or a Bearer API key from the dashboard.
Claude Code (mcp.json)
{
  "mcpServers": {
    "axis": {
      "url": "https://useaxis.dev/api/mcp"
    }
  }
}
2

Initialize your project

Run axis-init in your repo root to create the .axis/ directory with context files and IDE rule files for every agent ecosystem.
npx axis-init@latest
3

Start coordinating

Ask any connected agent to call get_project_soul to load context, then post_job to break down the work. Other agents on the same repo will pick up jobs from the shared board automatically.

​
Open-core model

Free forever

The full coordination layer — job board, file locks, shared notepad, sessions, and project soul — is free and open-source (AGPL-3.0). It costs nothing to run.

Pro (hosted)

The intelligence layer — hosted hybrid search, cited deep_search, incremental indexing, team dashboard, and managed backend — lives at useaxis.dev.
For solo developers on a single machine: Agent Teams (built into Claude Code) coordinates agents locally for free. Axis is for when the collisions stop being yours — multiple developers, multiple agent vendors, same repo.

Build docs developers (and LLMs) love

Get started for freeTalk to us