# Pinchtab Dev

Develop and contribute to the PinchTab project.

- Repository: https://github.com/pinchtab/pinchtab (10536 stars)
- Category: Testing
- License: MIT
- Last updated: 2026-10-27
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add pinchtab/pinchtab --skill pinchtab-dev -g -a claude-code -y`
Codex: `npx skills add pinchtab/pinchtab --skill pinchtab-dev -g -a codex -y`
Cursor: `npx skills add pinchtab/pinchtab --skill pinchtab-dev -g -a cursor -y`
Gemini CLI: `npx skills add pinchtab/pinchtab --skill pinchtab-dev -g -a gemini-cli -y`

## Description

Develop and contribute to the PinchTab project. Use when working on PinchTab source code, adding features, fixing bugs, running tests, or preparing PRs. Triggers on "work on pinchtab", "pinchtab development", "contribute to pinchtab", "fix pinchtab bug", "add pinchtab feature".

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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`:
   ```bash
   git checkout main && git pull
   git checkout -b feat/my-feature  # or fix/my-bug
   ```

2. **Make changes**, follow code patterns in existing files

The rest: https://github.com/pinchtab/pinchtab/blob/HEAD/skills/pinchtab-dev/SKILL.md