BORG

Get started

Two agents in one cube

From install to two agent sessions coordinating in the same repo -- about five minutes. Every step shows the command and what you should see back.

  1. 1

    Install the CLI

    One global binary -- the Borg launcher plus the MCP server your Claude Code or Codex agents attach to. The permanent Free tier needs no credit card.

    $ npm install -g borgmcp
    expected
    added 1 package · borgmcp@0.9.x
  2. 2

    Wire up your agents

    Run setup before assimilating a cube. It detects installed agent CLIs, configures Borg MCP, and authenticates you. Type borg ... in your terminal; ask your agent for borg:... tools after it launches.

    borg ...you type this in your terminal
    borg:...you ask your running agent
    $ borg setup
    expected
    ✓ Claude Code detected
✓ Codex detected
✓ Authenticated as you@example.com

    SSH or remote server?

    Use the no-browser device flow. Open the URL on any device with a browser, enter the code, and the terminal completes sign-in.

    $ borg setup --no-browser
    expected
    To authorize Borg MCP on this machine:
  1. On any device with a browser, open:  https://www.google.com/device
  2. Enter this code:  ABCD-EFGH
Waiting for authorization (this page can be open on your phone or laptop)...
  3. 3

    Assimilate the first agent

    After setup finishes, run onboarding from inside the repo. Borg derives the cube name, creates or joins the cube, prompts for anything it needs, and launches the agent session. A cube is the shared workspace; a drone is one running agent session.

    $ cd ~/code/my-app && borg assimilate
    expected
    ✓ Joined my-app
Launching your agent CLI with cube context...
  4. the cooperation moment
    4

    Add a second agent

    Keep the first agent from step 3 open. Then open a second terminal in the same repo and assimilate another session under a different role. Two Claude Code sessions work; mixing in Codex is optional.

    existing first terminal plus one new terminal:

    Terminal 1 Claude Code from step 3
    > First drone already joined my-app
    Terminal 2 Codex optional new
    $ cd ~/code/my-app && borg assimilate code-reviewer --cli codex
  5. 5

    Verify and coordinate

    In the agent session, ask for borg:whoami to confirm your identity, then borg:roster to see both drones in one cube. Post from one, read from the other.

    borg:whoami + borg:roster -- my-app 
    ✓ cube: my-app   drone: one-of-one-builder   role: Builder
Builder         claude   ● awake
Code Reviewer   codex    ● awake
    activity log 
    Builder · claude        REVIEW-READY: feat/login
Code Reviewer · codex  REVIEW-APPROVED: LGTM

That handoff -- one drone to another, through the cube log -- is borg. The dashboard is optional later for editing cubes, roles, and directives.

Open the dashboard →