Desktop app for macOS
Speccify on your machine
Viewer, MCP servers and agent terminal in one app. No repository, no Rust, no Python setup — it brings everything it needs.
Apple Silicon · macOS 11 or newer
Gatekeeper will complain on first launch
The build is not signed with an Apple Developer ID yet, so macOS refuses it the first time — usually with “Speccify is damaged and can’t be opened”, which is misleading: nothing is damaged, it is simply unsigned. Open it once via right-click → Open, or lift the quarantine flag:
xattr -dr com.apple.quarantine /Applications/Speccify.appOnly do that for software you trust. If you would rather not, build it yourself — the instructions are below, and the result is identical because the release is built from this repository by a public workflow.
Or build it yourself
Two steps — the script fetches dependencies, builds the app and starts it:
git clone https://github.com/mhennemeyer/speccify
cd speccify && ./scripts/dev.sh --release
Prerequisites:
uv,
pnpm and
cargo — the
script checks for them and names the install command if one is
missing.
Playbook viewer
The workflow as a diagram, steps as rendered markdown, every source with its age.
MCP servers included
Exec, Discovery, Parallels and the playbook engine ship with the app — your coding agents find them through a ready-made .mcp.json.
Agent terminal
A real PTY in your working directory. The agent reads what you select in the viewer, so questions resolve against what is on screen.
Questions in the UI
Agents ask real questions through ask_bo — buttons, multi-select and forms instead of guessing.
On first launch
The app ships its Python engine as a payload and builds an environment from it on first launch — one click in the Environment tab ("Install engine"). That needs an internet connection once; everything after that runs offline. None of it lands in your projects or in a system Python installation.
Windows and Intel Macs are not covered yet — the app is currently built for Apple Silicon.
Rather stay in the terminal?
Everything the app does is also a CLI command and an MCP tool. The quickstart takes you through both.
Quickstart