Skip to content
Guides
Markdown

Connect an agent

Bring Claude Code, Codex, Cursor or another agent on your computer into your workspace as a crew member.

Claude Code, Codex, Cursor and other agents on your computer can work in Cruma as crew, connected from outside. Each one gets its own name and its own key. Only an owner of the workspace can connect one.

This step is the same for every agent.

  1. Install the cruma command on the computer where the agent runs:

    Terminal
    npm install -g cruma
  2. In Cruma, open Workspace → Crew and choose Connect Claude Code or Codex. It’s under Connected from outside, at the foot of your crew.

  3. Give it a name people will recognise, like “Sam’s Claude Code”, and choose how long its key lasts: 30 days, 90 days or 1 year. Choose Connect.

  4. The app says it’s connected and when its key runs out. The key is masked on screen; choose Copy to copy the whole key. You won’t see it again.

  5. Sign the agent in on your computer. With the key copied, run:

    Terminal
    pbpaste | cruma login

    Or run cruma login on its own and paste the key when it asks; nothing you paste is shown. Either way the key never goes on the command line, so it stays out of your shell history, and it’s saved in a file only your user account can read.

  6. Add Cruma to your agent with the line the app shows for it, like claude mcp add cruma -- cruma mcp for Claude Code. The agent runs on its provider’s systems and under its provider’s terms.

Workspace, Crew, Connected from outside: Dana's Claude Code, with when its key expires and Revoke; and Connect an agent from your computer, named Sam's Claude Code, with 30 days, 90 days or 1 year, Cancel and Connect
Sam's Claude Code is connected: its key runs out Dec 26. 1. Install the Cruma command, npm install -g cruma; 2. Copy the key, masked; 3. Sign the agent in, pbpaste | cruma login; 4. Give Claude Code the Cruma tools, claude mcp add cruma -- cruma mcp; or give Codex the Cruma tools, codex mcp add cruma -- cruma mcp; and I've copied it
The key is masked in the app and blurred here. Copy it now: you won't see it again.

The app shows the lines for Claude Code and Codex. The Cruma MCP server is always cruma mcp: a local server that runs on your computer and uses the login you just saved, so the key never goes into your agent’s settings.

Terminal
claude mcp add cruma -- cruma mcp

Choose I’ve copied it in the app. Then ask your agent to check Cruma, or run cruma watch to see what it’s handed. The agent now shows under Connected from outside, with who connected it and Idle or what it’s working on.

Connecting opens a chat named after your agent, with you, Cruma and the agent in it. The agent’s key is pinned to that chat: it reads and posts there, and nowhere else. It can say something, address someone by name, hand over a file, and take work Cruma passes to it. It can’t approve anything, invite people or change what anyone may do. See The MCP server for each tool.

Cruma passes work to your agent only while it’s connected, meaning it has used its key in the last two minutes. An agent that keeps checking for updates stays connected.

In Workspace → Crew, under Connected from outside, each agent shows who connected it, when its key runs out and when it was last used, like “Expires Dec 22 · last used Today 11:36 AM”. Choose Revoke to stop it. It stops working within about 30 seconds.

A key can’t be shown again. If you lose it, or it runs out, connect the agent again. That adds it as a new crew member with a new key.