Skip to content

High-performance browser automation bridge and multi-instance orchestrator with advanced stealth injection and real-time dashboard.

docs: update pdev — interactive picker as default, new screenshot

Data50dd6ccc2f07
diff --git a/docs/architecture/building.md b/docs/architecture/building.md
index e4de52f1..852fda98 100644
--- a/docs/architecture/building.md
+++ b/docs/architecture/building.md
@@ -237,7 +237,8 @@ All dev scripts are accessible through `./pdev`:
```bash
./pdev # Interactive picker (uses gum if installed, numbered fallback)
-./pdev check # Run directly by name
+./pdev check # Run a command directly
+./pdev test unit # Subcommands supported
./pdev --help # List all commands
```
@@ -247,12 +248,16 @@ All dev scripts are accessible through `./pdev`:
| Command | Description |
|---------|-------------|
-| `check` | Run pre-push checks (format, vet, build, test, lint) |
-| `dev` | Build & run with dashboard |
-| `doctor` | Verify & setup dev environment |
-| `dashboard` | Build React dashboard |
-| `security` | Run gosec security scan |
-| `docs` | Check docs JSON structure |
+| `check` | All checks (Go + Dashboard) |
+| `check go` | Go checks only |
+| `check dashboard` | Dashboard checks only |
+| `check security` | Gosec security scan |
+| `check docs` | Validate docs JSON |
+| `test` | All tests (unit + integration) |
+| `test unit` | Unit tests only |
+| `test integration` | Integration tests only |
+| `build` | Build & run (default) |
+| `doctor` | Setup dev environment |
| `hooks` | Install git hooks |
For the fancy interactive picker, install [gum](https://github.com/charmbracelet/gum): `brew install gum`
diff --git a/docs/media/pdev-menu.jpg b/docs/media/pdev-menu.jpg
index 15cf8f47..73d21ca3 100644
Binary files a/docs/media/pdev-menu.jpg and b/docs/media/pdev-menu.jpg differ
diff --git a/pdev b/pdev
index 9b3cc8e1..ae4751b1 100755
--- a/pdev
+++ b/pdev
@@ -194,5 +194,9 @@ if [ $# -gt 0 ]; then
esac
fi
-# No args → default to build
-run_command "build"
+# No args → interactive picker
+if command -v gum &>/dev/null; then
+ pick_with_gum
+else
+ pick_with_select
+fi
diff --git a/scripts/README.md b/scripts/README.md
index b285a404..399cfeaf 100644
--- a/scripts/README.md
+++ b/scripts/README.md
@@ -2,24 +2,26 @@
Development and CI scripts for PinchTab.
-> **Tip:** Use `./pdev` from the repo root for an interactive command picker (or `./pdev <command>` to run directly).
-
-## Build & Run
-
-| Script | Purpose |
-|--------|---------|
-| `build-dashboard.sh` | Generate TS types (tygo) + build React dashboard + copy to Go embed |
-| `dev.sh` | Full build (dashboard + Go) and run |
+> **Tip:** Use `./pdev` from the repo root for an interactive command picker, or `./pdev <command>` to run directly.
## Quality
| Script | Purpose |
|--------|---------|
-| `check.sh` | Local pre-push checks (mirrors CI: gofmt, vet, build, test, lint, integration) |
+| `check.sh` | Go pre-push checks (format, vet, build, test, lint) |
+| `check-dashboard.sh` | Dashboard checks (typecheck, eslint, prettier, vitest) |
| `check-gosec.sh` | Security scan with gosec (reproduces CI security job) |
| `check-docs-json.sh` | Validate `docs/index.json` structure |
+| `test.sh` | Go test runner with progress (unit, integration, or all) |
| `pre-commit` | Git pre-commit hook (format + lint) |
+## Build & Run
+
+| Script | Purpose |
+|--------|---------|
+| `build-dashboard.sh` | Generate TS types (tygo) + build React dashboard + copy to Go embed |
+| `dev.sh` | Full build (dashboard + Go) and run |
+
## Setup
| Script | Purpose |