@geteigen/cli
CLI worker for Eigen — runs local Cursor, Claude Code, Codex, and OpenCode agents on your machine for multiplayer sessions hosted in the web app.
When you create a Local session in Eigen, prompts are relayed to this worker, which executes cursor agent, claude, codex, or opencode against a folder on your machine.
Protocol 10 is required for OpenCode, Protocol 5 for Codex, and Protocol 4 to forward chat images/files into the local workspace. Install/update:
npm i -g @geteigen/cli@latest
Requirements
- Node.js 18+
- Cursor CLI on your
PATH(cursorcommand) for Cursor agents - Claude Code CLI (
claude) for Claude Code agents - Codex CLI (
codex) for Codex agents - OpenCode (
opencode) for OpenCode agents - A Eigen account (sign in on the web app)
Install
npm install -g @geteigen/cli
Or from this repo:
cd cli
pnpm install
pnpm build
npm link
Quick start
- Sign in on the Eigen web app and open Pair CLI (
/cli-pair). - Generate a pairing code.
- On your machine:
eigen login
# Server URL defaults to https://cursor-multiplayer-agent.onrender.com — press Enter
# Paste the pairing code
cursor agent login # if not already logged into Cursor CLI
# For Claude Code / OpenCode local agents, ensure `claude` / `opencode` work in your shell
eigen start
- Keep
eigen startrunning while you use Local sessions in the browser.
Credentials are stored at ~/.config/steer/config.json.
Commands
| Command | Description |
|---|---|
eigen login | Pair with your Eigen account via a one-time web code |
eigen logout | Clear stored credentials |
eigen status | Show logged-in user, server URL, and your rooms |
eigen start | Start the worker (connects to the API over WebSocket) |
eigen start --repo <path> | Same, but force every prompt to use this repo path |
Server URL
eigen login defaults to:
https://cursor-multiplayer-agent.onrender.com
Override per login at the prompt, or with:
export STEER_SERVER_URL=http://localhost:3000
eigen login
Use the local URL when developing against a local API.
Run agents on a server or VM
Headless machines connect with a setup token instead of a browser login. In Eigen, open Machines → Add machine, choose personal or team (team machines can only be added by workspace owners/admins), and copy one of the commands it shows. Tokens are single-use by default and expire after 7 days.
One-line script (Linux/macOS — needs Node 20+ and git):
curl -fsSL https://www.geteigen.space/install.sh | sh -s -- --token mt_…
# optional: --agents claude,codex,opencode,cursor --name build-vm --no-service
Manual:
npm install -g @geteigen/cli
eigen connect --token mt_… # trades the token for this machine's credential
eigen service install # systemd (Linux) / launchd (macOS); starts at boot
Docker (Claude Code, Codex, OpenCode, and Cursor CLIs preinstalled):
docker run -d --name eigen-worker --restart=always \
-e EIGEN_MACHINE_TOKEN=mt_… \
-v eigen-worker:/root/.config/steer -v eigen-work:/work \
ghcr.io/adityaraj-09/eigen-worker:latest
Agents still need provider access on the machine: set ANTHROPIC_API_KEY /
OPENAI_API_KEY / CURSOR_API_KEY (or sign the CLIs in), or — on team
machines — keep the "use team keys" policy and Eigen sends the workspace's
keys with each run without storing them.
Managing it
eigen service status/eigen service logs/eigen service restart/eigen service uninstall- Auto-update: the service checks npm every 6 hours, installs a newer
@geteigen/cli, and restarts itself (systemd / launchd). Disable witheigen service install --no-auto-updateorEIGEN_AUTO_UPDATE=0. eigen updateinstalls the latest CLI and restarts the service now;eigen update --checkonly reports whether a newer version exists.eigen start --daemonruns in the background without a service- Work roots: sessions clone repos under the work root (
--root <dir>,EIGEN_WORK_ROOT,/workin Docker). Admins can also limit agents to allowed folders in Eigen → Machines; the worker refuses anything outside them. - Revoking: remove the machine in Eigen → Machines. It disconnects at once and its credential stops working; reconnecting needs a new setup token.
What the worker does
While eigen start is connected, the API can ask your machine to:
- List models for each installed agent (
cursor agent --list-models,opencode models, …) - Open a native folder picker for Local session create
- Run Cursor, Claude Code, Codex, or OpenCode prompts in the selected repo and stream events back to the room
- Stream tool results (including file paths and edit diffs) as each tool finishes so the web chat can group and inspect them
- Protocol 4+: write chat images/files into
.steer-uploads/in the repo so local agents can Read them - Protocol 3+: Claude Code backend + exclusive file locks before edit tools run (multi-agent conflict resolution)
- Protocol 10+: OpenCode backend (Anthropic / OpenAI provider keys or local CLI login)
Development
pnpm install
pnpm dev # run via tsx without building
pnpm build # compile to dist/
The published binary is dist/index.js (bin: steer).
License
MIT