Toolroll

Install Toolroll.

One command starts the app and a builder for your projects, then opens the console at 127.0.0.1:4180. Use the package manager you already have.

Runs on
macOS or Linux
Needs
Node.js 22.13+ and git
Agents
Claude Code, Codex or Gemini CLI
Keeps
One local SQLite database

Start it

npx toolroll up

Runs the latest release without installing anything.

Install with your agent.

Already working in Claude Code or Codex? Paste this, and your agent installs Toolroll, adds the project, learns how to hand work to it, and tells you what to do next. It asks before writing anything outside the repository.

Install Toolroll with `npm install -g toolroll` and start `toolroll up` in the background; it keeps running. Then run `toolroll onboard` in this repository, and run it again with `--yes` to install Toolroll's skill for you. Tell me the console address, where my login is saved (not the password), how to pair my phone, and what I can ask you next.

Works the same in Claude Code and Codex. Agents can also read toolroll.dev/llms.txt.

From install to your first task.

From a fresh install to a scope waiting for your approval. Try the sandbox first if you'd rather look around: npx toolroll demo never spends and never reaches outside.

  1. Start it

    It prints three lines and opens the console already signed in, through a one-time link that works once, for ten minutes, from this computer only.

    toolroll up

  2. Sign in an agent

    Claude Code, Codex or Gemini, signed in on this computer. Settings → AI providers shows which are connected.

    claude auth login

  3. Add a project

    Projects → add a folder or a GitHub repository. A repository you put in your projects folder later connects by itself. To switch on the starter flows (Fix failing CI, Issues become tasks, Overnight queue), run toolroll onboard --starter.

  4. Hand it a task

    Open Chat and say what you want in plain words. The lead drafts the goal, the boundaries and the checks for you to approve. Nothing is built until you do.

Pair your phone in Settings → Chat apps, then turn on approvals with toolroll chat-approval on. See every integration.

Review a finished build with toolroll task review <id> --brief for the outcome, checks and next action. Use --json for JSON.

Run it on your own domain; toolroll serve check-public tells you what's missing.

Keep it current.

Update, then start it again. Your database upgrades itself on the first start; a backup first is one line.

npm install -g toolroll@latest
brew upgrade toolroll
sqlite3 ~/.config/toolroll/orders.db ".backup orders-backup.db"

Before you start.

Short answers. The guides have the rest.