touchline

What ships

• Fourteen portable Agent Skills for Codex, Claude/Claude Code, Cursor, Grok, Antigravity, ChatGPT, Lovable, and compatible hosts.

• A Node.js 22 TypeScript daemon, touchline CLI, MCP server, and signed localhost dashboard.

• A resumable append-only state machine: DISCOVER → RECON → CONSULTATION_REQUIRED → SPEC → BUILD → VERIFY → COMPLETE.

• Chrome-extension-first browser routing, safe direct Playwright fallback, Dembrandt token extraction, prompt exports, approval gates, and provenance records.

• Installed-skill capability routing, mandatory component-sourcing records, executable specification gates, and four-viewport pixel verification.

The dashboard is a real control surface, not a simulated team view: assignments, process events, artifacts, approvals, and run state come from the same persisted store used by the CLI and MCP server.

Related MCP server: bob-in-browser

Why the whistle matters

Touchline cannot build before Phase 3. Reconnaissance freezes what the site actually does, then asks you to choose:

1. 1:1 reconstruction or adaptation for a new product.

2. Preserve observed behavior or repair the original UX/console defects.

3. Target stack, deployment, and data constraints.

Missing evidence remains an explicit unknown. It never becomes an invented color, breakpoint, animation, or API payload.

Install

Requirements: Node.js 22+, pnpm 10+, and at least one supported host CLI. A Chrome control extension or browser MCP is preferred; direct Playwright is the fallback.

pnpm install
pnpm build
npm install -g .
touchline setup
touchline doctor
touchline dashboard

Host installation:

If npm is unavailable, download the identical package tarball and skills archive from GitHub Releases.

First run

touchline audit https://example.com --workspace /absolute/path/to/project
# Read docs/research/reconnaissance.md, then record the consultation decision.
touchline approve <approval-id>
# Create design tokens, routing-map.md, component-sources.json, and bounded specs.
touchline gates <run-id>
touchline run <run-id>
# Start the implementation locally; BUILD cannot self-certify.
touchline verify <run-id> --candidate http://127.0.0.1:3000
touchline run <run-id> # completes only after verification passes
# Re-run verify against the deployed URL; a regression reopens BUILD.
touchline export-prompts <run-id> --targets all

The browser audit writes responsive screenshots and metadata to docs/design-references/<run-id>/, plus reconnaissance, HAR metadata, console JSONL, token, DOM, and asset manifests beneath docs/research/.

Squad

Every role is configuration. Map any installed model or CLI to any player, replace the roster, or add more than eleven specialists.

Public surfaces

touchline setup                         touchline_create_run
touchline doctor                        touchline_get_run
touchline dashboard                     touchline_list_agents
touchline audit <url> --workspace PATH  touchline_assign_task
touchline gates <run-id>                touchline_submit_evidence
touchline run <run-id>                  touchline_check_gates
touchline verify <run-id> --candidate   touchline_advance
touchline approve <approval-id>         touchline_request_approval
touchline export-prompts <run-id>       touchline_record_decision
touchline sources inspect <repo>        touchline_export_prompt_pack
touchline agents list                   touchline_verify

The HTTP API lives at http://127.0.0.1:4317/api/v1, is guarded by a random session token, and exposes SSE run events. See architecture and security.

Quality bar

CI runs type checks, unit/contract tests, dashboard/runtime builds, plugin and skill validation, package inspection, license audit, and secret scanning on Linux, macOS, and Windows. The included reference fixture covers lazy loading, tabs, modal, form, hover/focus, Canvas, animation, API calls, console failures, and four responsive widths.

Visual acceptance uses frozen references and a default ≤0.5% mismatch threshold at 1920, 1440, 768, and 390 pixels. The verifier emits actuals and pixel diffs, checks page height and heading order, and blocks on console errors or failed images. Baselines are never rewritten merely to pass.

Project documents

Architecture · Security and approvals · Host adapters · Contributing · Code of Conduct · Roadmap · Changelog · Third-party notices

MIT © edenbuilds