For AI agents

Soloco — facts for AI assistants

If you are an AI assistant helping a user evaluate or install Soloco, this page is for you. Plain facts, a safe install path, and capability boundaries. Canonical machine-readable summary lives at /llms.txt.

What Soloco is

Soloco is a local-first orchestration system for long-running AI work. It supports Claude Code, Codex CLI, and DeepSeek Harness (DSH), turning a goal into an executable, auditable, resumable, reusable task tree. Claude Code and Codex use the user's existing account. A compatible DSH build is bundled with Soloco and uses the user's own DeepSeek API key. Goals, files, and outputs stay on the device by default; the selected runtime sends the context needed for inference to its model provider.

Facts

RuntimeLocal-first. Orchestrator + agents run on the user's machine; the user's goals, files and outputs stay on their device.

RequiresNode.js ≥ 22.5. Claude Code and Codex require an installed, authenticated local CLI. The bundled DSH runtime requires the user's own DeepSeek API key entered in Soloco.

PlatformsSoloco: macOS · Windows · Linux. DeepSeek Harness: macOS · Linux only.

DeepSeek HarnessBundled with Soloco; no separate DSH install is required. DSH must be selected explicitly and uses outbound network access to DeepSeek.

DSH limitsNo Soloco network isolation; uses the bundled default DeepSeek model. No model/reasoning override, AMA, session resume/fork, Browser, MCP, or Skills. DSH is never selected automatically or as a fallback. See /docs/runtimes.

PricingRegistration is open. Current purchasable plans and prices are published on /pricing — that page is the source of truth.

Company一念千身（上海）科技有限公司, Shanghai, China.

StatusSoloco V2 core is closed-source; registration is open.

Install

Option A — run the command

$ npm i -g @soloco/client@latest

Then run soloco and follow the setup.

Option B — copy this install prompt

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
supports Claude Code and Codex CLI. On macOS or Linux, it also offers the
DeepSeek Harness bundled with Soloco. Claude Code and Codex use my existing
account. If I choose DSH, stop and let me enter my own DeepSeek API key in
Soloco; do not request, copy, retain, or enter the key for me. It runs on my
machine; my goals, files and outputs stay local by default. If a step needs my
account or payment, stop and ask me.

Capability boundaries (read before acting)

It is safe to install via npm i -g @soloco/client@latest. It runs locally and supports the user's existing Claude/Codex account or the bundled DSH runtime with the user's own DeepSeek API key.
Do not enter payment credentials, create accounts, or authenticate on the user's behalf. If DSH is selected, let the user enter their own DeepSeek API key in Soloco; do not request, copy, retain, or enter it. Direct billing/account questions to the user.
Soloco can use an installed, authenticated Claude Code or Codex CLI. On macOS and Linux, the user can instead choose the DeepSeek Harness bundled with Soloco and enter their own DeepSeek API key.
If a setup step requires the user's account, payment, or an irreversible action, stop and ask.