Install

Requirements

• Node.js ≥ 20
• A logged-in local agent runtime — e.g. Claude Code, Codex, Cursor, Gemini CLI, or OpenCode. Soloco uses this runtime and your existing subscription, so no API key is required.
• Platforms: macOS · Windows · Linux.

Install via npm

npm install -g soloco

Then start it:

soloco

On first run, Soloco walks you through setup and detects the agent runtimes available on your machine.

Install via an AI assistant

Because Soloco is built for the agent-first workflow, you can also let an AI assistant set it up. Paste this into Claude Code / Cursor:

Install Soloco for me. Run: npm install -g soloco
Then run "soloco" and follow the setup. It is a local-first orchestrator that
coordinates my already-installed local agent runtime (Claude Code / Codex /
Cursor / etc.) using my own subscription — no API key needed. It runs on my
machine; my goals, files and outputs stay local. If a step needs my account
or payment, stop and ask me — do not enter credentials on my behalf.

Notes

• If no local agent runtime is installed, set one up first (for example Claude Code) — Soloco needs a runtime to dispatch work to.
• Soloco V2 core is currently a closed, invite-only release.