Workbench
Free everyday Mac tools for speaking, explaining and presenting.
Download Workbench · Product guide · Contribute · Mac release gate
Workbench brings Annotate, Voice to Text, Snap and Present into one native Mac app. Present includes the phone stage, live camera, profile/persona and optional voice wave. Snap & Talk is available through Settings → General → Experimental features, disabled by default. Meetings runs as a separate, privately distributed Mac app; existing recordings and transcripts are preserved for explicit copy-only import, and remain accessible from Workbench without installing Meetings.
Current focus: get Mac right
Mac desktop quality is the active priority. iPhone, iPad and the Chrome extension are paused. Their existing code and research remain available, but we are not accepting platform expansion or preparing those releases while the Mac release gate is open. Resuming a platform requires an explicit new decision.
The public app is Workbench. Workbench Preview is the separate development edition used by contributors. A Preview package is never the production download. The release gate records current acceptance; the website reads the verified release receipt for its download and version. Historical preview notes describe their dated builds, not today's release status.
Three surfaces, one app
| Surface | Purpose |
|---|
| Menu-bar panel | Start utilities, make quick adjustments, configure shortcuts and recover from problems. |
| Floating toolbar | Carry out the current workflow without leaving the task or disrupting the demonstration. |
| Desktop app | Prepare scenes and personas, organise saved prompts, review captures and configure deeper settings. |
These surfaces share the same underlying jobs and saved resources. Starting or adjusting one utility must preserve independent work. The product contract owns the interaction direction; older proposals are historical input.
Get started
- Install Workbench from the website. Open it from Applications.
- Open Settings → Models to prepare the default local Parakeet recognizer, then try Voice to Text with a disposable sentence. The first model download can take several minutes.
- Use the menu bar for quick actions and the floating toolbar while working. Open the desktop app for preparation and review.
- Open Settings → Keyboard to see, change or practise shortcuts. Recording a shortcut temporarily suspends Workbench's global shortcuts.
- Choose Update to [version] in the sidebar when an update is ready; Settings › General › Updates checks and holds the automatic options. Use Copy build details when reporting a problem.
Closing the desktop window leaves Workbench available. Quit Workbench stops the app. Open at login is optional. Older releases without the updater need one manual upgrade; see installation and updates.
The product guide explains the core tools, experimental Snap & Talk, presentation sources and saved resources. Device presentation is video-only; Apple's QuickTime and iPhone Mirroring remain separate apps. A connected iPhone used as a Mac presentation source does not imply an active Workbench iOS release.
Team packs (2.2+): open Library → Packs, connect GitHub and add the private repository link your team shares. Choose a compatible skill or import your own scene/persona copy. New sessions carry the complete versioned skill and resources for the existing Hand off flow. Share the installation guide and pack link with colleagues. Ordinary Workbench tools remain account-free; existing sessions keep their own files.
Build and install Preview
Develop on main in Ship-Work/workbench. Branch from current main and return changes through a PR. Voice and StageKit are modules here; a separate legacy checkout is unnecessary.
Source development requires an Apple Silicon Mac, macOS 14+, Swift 6.2+ and the macOS 26 SDK. Full Xcode is required for distributable Shortcuts metadata. The deployment target is not evidence of testing every older OS or device.
The suite runs with Workbench open. Two StageKit checks need the exclusive default shortcuts free; while Workbench, Workbench Preview or a legacy Voice/StageMark copy holds them, those two are reported as SKIP, naming that app, and the rest still counts. Quit the app to run them here; CI runs them in full.
bash scripts/doctor.sh
bash scripts/test.sh
REQUIRE_APP_INTENTS=1 bash scripts/build.sh --preview
bash scripts/install.sh --archive "dist/Workbench Preview.zip" --no-open
The persistent Preview workflow requires a Developer ID Application certificate and private key. The installer preserves its identity, location, saved data and previous package. The ordinary bash scripts/build.sh creates a disposable ad-hoc Preview archive without installing it. Do not use that archive to replace a persistent signed installation.
Follow the shared installation and release workflow. One integration owner controls the shared installed Preview. Source tests, installed acceptance, merged code and public delivery are separate facts. Local builds identify themselves and do not take public updates. Stable and Preview have separate identities, saved data and signed feeds; switching editions never silently copies live data or permissions.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
