Skip to content
Projects

badhope/workbench has 49 GitHub stars and 6 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 17:53 UTC. Last push 2026-11-13.

How these counts are measured

What you can do

  • Workbench home - Overdue / today / doing / blocked / inbox counts; current project with goal, progress ring and next step; quick capture to inbox
  • Projects & tasks - Projects with goal, status and progress; tasks with status, priority, due date, next step, blocked reason and completion timestamp; list + kanban views; keyboard and pointer workflows
  • Monitoring - Live processes, listening ports (netstat on Windows, ss -tulpn on Linux with a netstat fallback) and dev-server detection with framework + confidence
  • Process tree - Flat table or parent/child tree from parent_pid; orphan and cycle-safe, virtual scrolling, per-row detail with the process's own listening ports, CSV export

Measured star growth

in 24h
0
in 7 days
Update delayed
in 15 days
Update delayed
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Workbench - a local-first desktop workbench (Tauri 2 + React 19): live process / port / dev-server visibility + AI session token cost metering. All data stays on-device. MIT licensed.

Developer Tools

README.md

Original

Workbench

English | 简体中文 | 日本語

Version License Platform Tests

Workbench

See the port. Find the process. Know the cost. Finish the work.

A local-first desktop workbench for people who run services and AI coding agents on their own machine. One window shows today's work, every project and task, each listening port and its process, and what Claude Code / Codex sessions actually cost. Data never leaves the device — no account, no cloud, no model to configure.

What makes it different

Today first The home screen answers "what should I do now" — overdue, due today, in-progress, blocked and inbox at a glance — not a wall of CPU gauges.
Port → process → cost A listening port links to the process that owns it, and a process shows every port it holds. Session files connect the same machine's work to real spend. No other local tool joins those three views.
Projects, not folders A project has a goal, progress and next action. Tasks carry status, priority, due date, next step and blocked reason. The local folder is metadata, not identity.
Keyboard-first Ctrl/Cmd+K searches pages, processes, ports, projects and tasks, then lands you inside the result — filtered to the project, focused on the task.
Local-first, honestly SQLite ledger on your disk, CSP locked to self, no telemetry. The only outbound request is the optional probe of a local opencode server.

Three ways to run it

Mode Start it What you get
Desktop install the bundle, or npm run tauri dev The full app: tray, global shortcut, mini window, elevated kill, native notifications
Web workbench serve The same backend over HTTP on 127.0.0.1:7788, serving the built UI to your browser. Real data, not demo. Machine state is read-only; kill and log-clear stay desktop-only
Demo open the deployed landing page Static sample data so the UI can be evaluated without installing anything

The header badge always says which one you are looking at — Live, Web · live data or Demo — so a number on screen is never ambiguous about being real.

Screenshots

Today (workbench) Review
Today Review
Current project, today list, quick capture, attention chips Completion trend, project progress, status & priority split
Processes Servers & ports
Processes Servers
Flat / tree view, virtual scrolling, CSV export netstat / ss parsing, dev-framework tags
Cost ledger Tasks
Costs Tasks
Budget progress, trend, model split List + kanban, status & blocked markers
Command palette Mini window
Palette Mini
Ctrl/Cmd+K across pages, processes, ports, projects, tasks Current work + today + quick capture, always on top

Features

Feature What you get
Workbench home Overdue / today / doing / blocked / inbox counts; current project with goal, progress ring and next step; quick capture to inbox
Projects & tasks Projects with goal, status and progress; tasks with status, priority, due date, next step, blocked reason and completion timestamp; list + kanban views; keyboard and pointer workflows
Monitoring Live processes, listening ports (netstat on Windows, ss -tulpn on Linux with a netstat fallback) and dev-server detection with framework + confidence
Process tree Flat table or parent/child tree from parent_pid; orphan and cycle-safe, virtual scrolling, per-row detail with the process's own listening ports, CSV export
Command palette Ctrl/Cmd+K fuzzy search over pages, processes, ports, projects and tasks; lands filtered on the project or focused on the task detail
AI cost metering Token costs of local Claude / Codex sessions in a SQLite ledger — no model, no API key, nothing leaves your machine
Review Completion trend (14-day), project progress, status and priority distribution — all computed from real data, with honest disclosure of what lacks history
Pricing editor 40+ built-in model prices; edit / add / reset overrides from the UI
Backup & restore Timestamped snapshots with one-click rollback and integrity checks (VACUUM INTO + PRAGMA integrity_check)
Mini window A compact always-on-top companion showing current project, today's tasks and quick capture; syncs with the main window via BroadcastChannel
Start at login Real OS registration (registry / autostart entry), toggle reads back from the OS
Environment check Per-item ok / warn / fail report for platform, data directory, cost DB, session folders and port tools, with a copyable summary
CLI mode One binary: ps / ports / diag / cost / serve (all support --json); scriptable, no window
Visual system 7 overview layouts × 16 themes × 3 shells, draggable & hideable widgets with per-widget widths, theme editor with share links
Trilingual UI 简体中文 (default) / English / 日本語
Cross-platform CI defines Windows, Linux and macOS jobs, including Linux .deb and macOS .app builds

Quality gates

Every claim in this README is verified by a command. The same steps run locally (node scripts/ci-local.mjs) and in CI:

Gate What it catches
npm run version:check the four version files drifting apart
npx tsc --noEmit type errors, including the generated IPC contract
npm run lint · npm run format:check zero-warning ESLint, Prettier
npm test 575 frontend tests with an enforced threshold
cargo test --lib 172 backend tests, plus the ts-rs binding export
npm run test:e2e 25 Playwright cases: navigation, WCAG AA contrast, visual baselines
cargo clippy -- -D warnings Rust lints, zero tolerated
npm audit · cargo audit known vulnerabilities in either dependency tree

Build

Requires Node.js ^22.22.2 || ^24.15.0 || >=26.0.0 and Rust ≥ 1.90:

npm install
npm run tauri dev      # desktop dev mode (hot reload)
npm run tauri build    # installers → src-tauri/target/release/bundle/

Local CI mirror (same steps as .github/workflows/ci.yml):

node scripts/ci-local.mjs          # typecheck → lint → format → unit → build → Playwright → cargo
node scripts/ci-local.mjs --fast   # skip the visual-regression pass

Command line (same executable, no window):

workbench ps              # every process: pid, name, cpu%, memory, parent, status
workbench ports           # listening TCP/UDP ports with the owning PID
workbench diag            # environment self-check
workbench cost            # AI session cost summary (--days N, --by-project)
workbench serve           # headless HTTP API + web UI on 127.0.0.1:7788
workbench ports --json    # machine-readable output for scripts

Tech stack, project structure, FAQ and everything else live in the architecture & reference doc (简体中文 / 日本語).

Contributing & License