Documentation
Documentation
How TermPuzzle preserves your project context — from first install to restoring a whole workspace in one click.
Early docs — expanding with each release. Latest: v0.4.5.
Getting Started
TermPuzzle is a desktop app that remembers your project's context — its terminals, running services, editor, and AI sessions — so you restore an entire working environment in one click instead of rebuilding it by hand.
The flow is: install → open a project folder → arrange your terminals, editor and agents once → TermPuzzle saves that as a workspace spec. From then on, one click restores it.
Installation
Download the desktop app for your platform. It runs entirely on your machine.
- macOS — signed & notarized (Apple Silicon + Intel), or
brew install --cask ElBartox/termpuzzle/termpuzzle. - Windows — installer
.exe. First run may show a Defender notice → More info → Run anyway (signed builds coming). - Linux — AppImage and
.deb.
Workspace Restore
Restore reopens a project exactly as you left it: terminals relaunch their commands, the editor opens in position, and agent windows come back on task. Services are resumed, not rebooted, and paths that don't exist on a new machine are re-mapped instead of failing.
Project Pulse
Project Pulse is your project's operational memory — a live 0–100 health score across every service, right in the window chrome. When a service drops, TermPuzzle catches it and can recover it before you notice, and logs the event on the Timeline.
AI Mission Control
Run Claude Code, Cursor, Codex, Aider or Continue as first-class terminals inside a workspace. They survive project switches and restore on relaunch, so an in-flight session isn't lost when you swap projects. TermPuzzle reads only PTY activity (working / waiting) — never the content of your prompts.
See Architecture for how this is built, or the FAQ for common questions.