Design, manage, and automate terminal workspaces — for cmux and Ghostty.
Save layouts by name. Restore them anytime. Switch between them in seconds. Resume AI coding sessions mid-conversation. Launch workspaces from Alfred. 🐦🔥
|
💾 Save & Restore 📦 16 Templates 📝 Markdown Blueprints |
🤖 AI Auto-Detection 🔍 Alfred Integration NEW ⚡ Auto-Accept NEW |
brew install drolosoft/tap/crex # install
crex setup # first-run wizard (ships a demo layout)
crex restore demo # try the bundled example — safe anywhere
crex save my-day # snapshot your layout
crex restore my-day # bring it all back
crex pop # instant workspace picker (Ctrl+G)
Also available via
go install github.com/drolosoft/cmux-resurrect/cmd/crex@latest. See Building.
Type crex pop or hit Ctrl+G — a floating picker with fuzzy search across all layouts, templates, and individual workspaces.
Tab into any layout to browse its workspaces:
Search and restore workspaces directly from Alfred. Type crex + your query — every saved workspace is searchable by name.
| Key | Action |
|---|---|
| Enter | Restore workspace |
| Cmd+Enter | Restore full layout |
| Alt+Enter | Show layout details |
| Ctrl+Enter | Open TOML file |
Works with both cmux and Ghostty. See Alfred setup guide for installation.
crex template use ide
16 built-in templates — from simple splits to monitoring dashboards. See the Template Gallery.
crex save detects running AI sessions and captures their session IDs. On restore, each resumes exactly where you left off.
crex❯ save my-day
📦 my-day
7 🧩 drolosoft 📌
├── claude --resume 90d6d97b... ★
└── →right 🌐 https://drolosoft.com/
🚀 Homepage 📌
├── npm run dev
├── →right nvim CLAUDE.md ★
└── →right 🌐 http://localhost:3000/
15 tools supported: Claude Code, OpenCode, Codex, Amp, Gemini CLI, Copilot, Grok, Cursor, Aider, and more. Any foreground process (npm, nvim, htop) is also detected and restored.
And it works both ways — crex skill install teaches Claude Code and Codex to drive crex themselves: snapshot before risky changes, restore layouts non-interactively, resume sessions. See crex skill.
Configure auto-accept to skip permission prompts on restore — agents start in autonomous mode automatically.
crex tui — a REPL with browse mode, numbered items, history, and tab completion.
| Backend | Status | Detection |
|---|---|---|
| cmux | Full support | Auto-detected via CMUX_SOCKET_PATH, verified alive (falls back to a running Ghostty if the socket is dead) |
| Ghostty | Full support | Auto-detected when running |
macOS only. Both backends auto-detected — same commands, same templates, same Blueprints. Per-pane working directories work on both; exact split geometry is cmux-only for now (backend differences).
| cmux native | crex | |
|---|---|---|
| 🔄 | Restores last session on relaunch | Named layout library — switch between saved layouts |
| 📐 | No templates | 16 built-in templates |
| 📝 | JSON snapshots | Markdown Blueprints — Obsidian-compatible |
| 🔍 | AI tools via hooks | Any foreground process — npm, vim, htop, all detected |
| ⚡ | Automatic on relaunch | On-demand — filter, dry-run, restore specific workspaces |
| ⏱️ | Saves on quit | Watch daemon — background auto-save |
| Commands | Full command reference |
| Templates | 16 built-in templates with diagrams |
| Blueprints | Markdown workspace definitions |
| Alfred | Alfred workflow setup |
| Configuration | config.toml, auto-accept, env vars |
| Auto-Save | Daemon, shell hooks, launchd |
| Shell Completion | bash, zsh, fish setup |
| Workflows | Save/Restore vs Import comparison |
| Building | Build from source |
Contributions welcome — bug fixes, templates, feature ideas. Open an issue or PR.
If crex saves your sessions, a ⭐ helps others discover it.
MIT License · Forged by Drolosoft · Tools we wish existed