ttol

Run your coding-agent sessions from the browser.

ttol connects a machine you own to the web. Drive Claude Code sessions in your projects from here, and each session distills — locally, on your subscription — into a versioned recipe of how the work was built. Connect a machine with one command:

Connect a machine

Paste this in the machine's terminal. It installs the CLI, opens your browser to authorize the machine (sign in, check the code, click once — no token copy-paste), turns on session capture, and installs the daemon as a boot service:

curl -fsSL https://citrepo.com/connect.sh | sh
  • Headless box? The approval URL also prints in the terminal — open it from any device.
  • New projects land under ~/projects (override with TTOL_PROJECTS_ROOT=<dir>); skip the boot service with TTOL_NO_SERVICE=1.
  • Outbound-only: the machine polls the server; nothing can reach in, and every action still asks for approval in your browser.
Prefer the manual steps?

  1. Install the CLI

    Installs to ~/.ttol/bin. Re-run any time (or `ttol update`) to upgrade.

    curl -fsSL https://citrepo.com/install.sh | sh

  2. Register this machine

    Create your account with “Sign in with GitHub” above first. Mint a machine token in Settings → Machines and paste it at the prompt (the paste isn't echoed). This machine token is what the daemon uses — don't run ttol login on this machine; it would overwrite the token.

    ttol machine register --host https://citrepo.com

  3. Enable session capture

    Installs the Claude Code SessionEnd hook so every finished session — web or terminal — distills into the project's recipe.

    ttol enable-hooks

  4. Start the daemon

    Connects outbound only (no inbound ports). --parity enables full terminal-parity web sessions with permission prompts relayed to your browser; --projects-root lets you create brand-new projects from the web UI.

    ttol machine daemon --parity --projects-root ~/projects

The machine then shows online here — and from now on everything happens in the browser. No more terminal.

Launch a project — from the browser

With a machine connected, you create and build projects entirely from the web UI — the agent runs locally on your machine, under your own subscription, and streams back here.

  1. Open Support → “Your machine”

    In the nav, open Support and switch to the “Your machine” tab, then pick your online machine.

  2. New project on this machine…

    Click it, name the project (lowercase letters, digits and hyphens — e.g. kimi-k3), and Create. ttol scaffolds a fresh project directory on your machine and it appears in the picker.

  3. Choose Full access (parity), and confirm

    A full-toolset session, just like your terminal — every action not already allowed asks you for approval right here in the browser.

  4. Start building

    A Claude session runs in the new project on your machine and streams to the browser: approve actions inline, steer mid-turn, close the tab and re-attach. End session captures the work into the project’s recipe.