PinchTab Development

PinchTab is a browser control server for AI agents, Small Go binary with HTTP API.

Project Location

Run everything from the repository root (a clone of github.com/pinchtab/pinchtab).

Dev Commands

All development commands run via ./dev:

Command	Description
./dev build	Build the application
./dev dev	Build & run
./dev dashboard	Hot-reload dashboard development (Vite + Go)
./dev run	Run the application
./dev check	All checks (Go + Dashboard + Plugin)
./dev check go	Go checks only
./dev check dashboard	Dashboard checks only
./dev test unit	Go unit tests
./dev test dashboard	Dashboard unit tests
./dev e2e basic	Basic suite (api + cli + infra)
./dev e2e extended	Extended suite (all extended)
./dev e2e smoke	Smoke suite
./dev smoke	Host Docker smoke checks (--browser=chrome|cloak|all)
./dev e2e test "<name>"	Run a single E2E test by start_test name
./dev all	check + test + e2e extended (pre-push gate)
./dev binaries	Build the full release binary matrix into dist/
./dev doctor	Setup dev environment

Architecture

cmd/pinchtab/     CLI entry point
internal/
  bridge/         Chrome CDP communication
  handlers/       HTTP API handlers
  server/         HTTP server
  dashboard/      Embedded React dashboard
  config/         Configuration
  routes/         API route catalogue
  assets/         Embedded assets (stealth.js)
dashboard/        React dashboard source (Vite + TypeScript)
tests/e2e/        E2E runner, fixtures, scenarios/{api,cli,infra,plugin}/

Workflow: New Feature or Bug Fix

1. Create branch from main:

   git checkout main && git pull
   git checkout -b feat/my-feature  # or fix/my-bug
   

2. Make changes, follow code patterns in existing files