Install

Requirements

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

Install via npm

npm i -g @soloco/client@latest

Then start it:

soloco

On first run, Soloco walks you through setup, detects the agent runtimes available on your machine, and opens the local UI in your browser.

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 or Codex:

Install Soloco for me. First check Node.js ≥ 22.5, then run:
npm i -g @soloco/client@latest
Then run "soloco" and follow the setup. It is a local-first orchestrator that
coordinates my already-installed local agent runtime (Claude Code / Codex /
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.

Stay up to date

soloco update

Or reinstall the latest version: npm i -g @soloco/client@latest.

Check your install

If something isn't working, run the built-in diagnostic:

soloco doctor

It reports each item with a next step: your Node version (Soloco needs Node ≥ 22.5), whether the daemon is running and serving the local UI, and whether a local agent runtime is installed and logged in. On too-old Node, soloco prints an upgrade message instead of running — install Node 22.5 or newer, then reinstall with npm i -g @soloco/client@latest.

To see which runtimes Soloco detected, run soloco runtimes.

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 closed-source; registration is open — install it and sign in with your account.