Documentation

Getting started with ManyHands orchestration

Quick Start

1. Install the CLI

curl -fsSL https://manyhands.dev/cli/install.sh | bash

2. Authenticate

manyhands login

Opens browser for Google or GitHub sign-in.

3. Configure the MCP server

claude mcp add manyhands -- manyhands mcp

Registers the ManyHands MCP server with Claude Code.

4. Start a build

manyhands start "Build a REST API with FastAPI and PostgreSQL"

Opens the web configure page. Adjust settings and launch.

CLI Reference

manyhands loginAuthenticate via browser OAuth

manyhands start [description]Start a new orchestration run

manyhands start --file prompt.mdStart from a prompt file

manyhands statusCheck status of active runs

manyhands cancel [run_id]Cancel a running build

manyhands logoutClear stored credentials

MCP Server Integration

ManyHands exposes an MCP (Model Context Protocol) server that lets any MCP-compatible client trigger orchestration runs. This enables integration with Claude Code, Cursor, and other AI tools.

Available Tools

plan_prompt

Get a structured prompt template for complex projects. Claude fills it in by asking clarifying questions, then presents the finished spec.

start_orchestration

Start an orchestration run. Accepts inline description or file path, optional project name, and optional source_bundle for existing codebases.

bundle_project

Package a local project directory as a .tar.gz bundle for use as source_bundle. Excludes .git, node_modules, __pycache__, .venv, and files >50MB.

check_status

Check the status of a running orchestration by run ID. Returns a compact summary by default. Supports filtering: include=['workers','logs'], log_filter (regex grep), log_types (e.g. 'qa_issue'), and head/tail limits.

list_runs

List recent orchestration runs with their statuses.

cancel_run

Cancel an active orchestration run. Kills local worker processes.

resume_run

Resume a failed or canceled run from its latest snapshot. All completed work is restored. Requires Pro tier.

iterate_run

Continue a completed run with new or changed requirements. Builds on existing project code with delta research. Requires Pro tier.

subscribe

Open the billing page to upgrade your plan. Required for resume_run and iterate_run.

Configuration

Add to your MCP client configuration:

{
  "mcpServers": {
    "manyhands": {
      "command": "manyhands",
      "args": ["mcp-server"]
    }
  }
}

Web Dashboard

The web dashboard at manyhands.dev provides:

◆Project management: Create projects, edit specs, view run history.
◆Run configuration: Select models per agent role, set worker count, spending caps.
◆Live monitoring: Pipeline visualization, worker status, real-time logs, cost tracking.
◆QA reports: Automated issue detection with severity ratings and auto-fix status.
◆Downloads: Download completed projects as ZIP files.