Axis

@virsanghavi/axis-server

チームのコーディングエージェントが共有する、ひとつの調整ボードです。

チームメイトの Claude Code が、今 auth.ts を編集中です。あなたの Cursor も、これから編集しようとしています。どちらも互いの作業を把握しておらず、git で分かるのは事後のことだけです。

Axis は、プロジェクト内のすべてのエージェントに共有ジョブボードを提供し、ファイルを編集する前に必ずロックを取得させる MCP サーバーです。異なる人が、異なるマシンで、異なるツールを使って実行するエージェントが、同じボードを通じて連携します。

agent-A  propose_file_access src/auth.ts   ->  GRANTED
agent-B  propose_file_access src/auth.ts   ->  REQUIRES_ORCHESTRATION
                                               held by agent-A: "adding refresh tokens"

インストール

npm install -g @virsanghavi/axis-server

エージェントを接続する

Claude Code：

claude mcp add --scope project --transport http axis https://useaxis.dev/api/mcp

Cursor、Claude Desktop、Windsurf など、MCP に対応したものをクライアントの設定ファイルで設定します。

{
  "mcpServers": {
    "axis": {
      "url": "https://useaxis.dev/api/mcp"
    }
  }
}

OAuth で認証するため、管理が必要なキーはありません。useaxis.dev の Bearer API キーも使用できます。ツールはサーバー側に配置されるため、変更があってもお使いのマシンで更新する必要はありません。

ローカルで実行する場合

複数の人の間で連携できるのは、ホストされたボードだからです。サーバーを独自のプロセスで実行する場合：

axis-server

変数	用途
AXIS_API_KEY	ボードの認証情報。useaxis.dev から取得します
AXIS_API_SECRET	そのキーに対応するシークレット
AXIS_ORG_ID	複数の組織に所属している場合に、ボードをひとつの組織に固定します
AXIS_WORKSPACE_ROOT	エージェントホストがリポジトリのルートを指定しない場合の、リポジトリのルート

Axis はアクティブなリポジトリからプロジェクトの ID を特定し、エージェントが別のリポジトリに移動すると自動的に切り替わるため、ジョブやロックがリポジトリ間で混在することはありません。

エージェントが利用できる機能

連携：post_job、claim_next_job、complete_job、list_jobs、propose_file_access、verify_file_lock、release_file_access、list_locks、list_agents、finalize_session。

共有コンテキスト：get_project_soul、update_project_soul、update_shared_context、read_context、search_codebase、search_docs。

なぜ git worktrees ではないのか

worktrees はファイルを分離しますが、作業意図は分離しません。別々の worktree を使う 2 つのエージェントが、どちらも認証のリファクタリングを次の作業だと判断し、どちらも正しく実装して、マージ時に競合が一切起きないこともあります。コストを 2 倍かけたうえで、片方を捨てることになります。作業を始める前に担当を決めるという点は、worktrees では実現できません。

リンク

• useaxis.dev
• 2 つのエージェント、ひとつのファイル
• ソース

AGPL-3.0。