Quick Start

Install coco from scratch

Follow this guide in order: install VS Code, register your coco account, run the one-line installer, and configure your model API. Once you're done you can drive coco in plain English (or any language) to handle code, docs, research and more — right from your terminal.

macOS · Apple Silicon Windows 10 / 11 · x64
PART 01 — Run coco inside VS Code's built-in terminal

Install VS Code

VS Code is Microsoft's open-source code editor — free on every platform, with the largest extension ecosystem out there. Its built-in integrated terminal runs coco directly, so you can edit code and drive coco in the same window without switching tools.

Download: https://code.visualstudio.com/ (macOS / Linux / Windows, free)

After downloading, follow these two steps to open the terminal panel:

  1. 1

    Download and install VS Code

    Open code.visualstudio.com, grab the installer for your OS and install it the usual way:

    • · macOS — unzip the download, drag Visual Studio Code.app into Applications
    • · Windows — run the .exe and click through the installer with defaults
    • · Linux — install the .deb / .rpm package, or search for "Visual Studio Code" in your software center
  2. 2

    Launch VS Code and open the built-in terminal

    Open VS Code and look at the toolbar in the top-right corner of the window — there are 4 small icons; click the third one (the one with the bottom half highlighted, tooltip Toggle Panel). A terminal panel pops up at the bottom of the window.

    You can also use the menu Terminal → New Terminal, or the shortcut Ctrl + ` (Windows / Linux) / ⌘ + ` (macOS).

✓ VS Code and the terminal are ready. In Part 3 you'll paste the coco install command straight into that terminal panel — first, register your coco account.
PART 02 — Create your account at coco.sinoaus.net

Register your coco account

  1. 1

    Visit the coco website

    Open coco.sinoaus.net in your browser, then click Sign up in the top-right corner.

  2. 2

    Enter your invitation code + email

    Fill in the invitation code and email sent to you by your sales rep or team admin, then set a password as prompted. Submitting creates your account.

  3. 3

    Sign in to the dashboard

    After successful registration you'll be signed in to the dashboard at /dashboard automatically. If you need to sign in again later, click Sign in in the top-right.

PART 03 — One-line install inside the VS Code terminal

Install coco

  1. 1

    Confirm your subscription is active

    Sign in to the dashboard. The "My subscription" section at the top should show ● Subscription active. If your subscription is not active, the install section below will not show the "Get install command" button.

    • · Team owner — first-time purchase: if it shows "No active subscription", click Subscribe now, pick a seat count (1+) and a period (6 / 12 months), submit, and complete payment via Alipay. The subscription activates instantly.
    • · Renewal / scaling up: same entry point at /subscription — adjust seats and resubmit.
    • · Members invited into a team: the team owner pays; you only need to wait for them to activate. No separate subscription required.
  2. 2

    Get the install command from the dashboard

    Once your subscription is active, the dashboard at /dashboard shows an Install coco CLI section. Click Get install command.

    The page reveals two independent command blocks: macOS / Windows. Pick the one matching your OS and click Copy.

  3. 3

    Paste into the VS Code terminal and press Enter

    Switch back to VS Code, paste the copied command into the terminal panel you opened in Part 1, and press Enter.

    The command looks roughly like this (illustrative — always use the one copied from your dashboard):

    curl -fsSL https://coco.sinoaus.net/install/<token> | bash && export PATH="$HOME/.local/bin:$PATH" && hash -r && coco
  4. 4

    The installer takes care of the rest

    The installer runs these steps in order:

    1. Detect runtime dependencies (Node.js, Git, package manager) — installs missing ones automatically.
    2. Clean up any old install (your skills / memory / agents are preserved).
    3. Download the platform-specific coco client and verify its checksum.
    4. Unpack, write the identity file, configure PATH.
    5. Launch coco.

    The whole thing usually takes 1–3 minutes (depending on network speed). No manual intervention needed — just wait.

PART 04 — Bind this device to your coco account

Browser authorization

After install, coco launches itself and a browser window pops up after a few seconds — this is the first-time device-authorization flow that registers this machine under your coco account.

On the browser page that appears:

  1. Confirm it shows your own coco account.
  2. Verify the device fingerprint (OS, machine name) matches.
  3. Click Authorize.

On success, the browser shows ✓ Device bound. Switch back to the VS Code terminal — coco is now in its main UI.

ℹ The auth token is cached locally at ~/.coco/cloud/auth.json (on Windows: %USERPROFILE%\.coco\cloud\auth.json). Future launches on this machine won't ask for re-authorization.
CONTINUE — Sign in to unlock advanced content

Setup complete — sign in to read the advanced guide

You've installed coco, registered, and authorized your device. The remaining sections are gated to signed-in users and cover:

  • · Part 5 · Configure your model API (and Tavily search)
  • · Part 6 · Drive coco with plain language — 9 real-world scenarios across multi-agent / skills / cron / MCP / multimodal / SRE / data analysis
  • · Part 7 · Full reference for all 49 slash commands
  • · Frequently asked questions
Sign in to continue → No account yet? Register