Skip to content

drolosoft/cmux-resurrect

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

404 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

crex logo

crex (cmux-resurrect)

Ghostty cmux GitHub Release Go Report Card License: MIT Homebrew

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. πŸ¦β€πŸ”₯

crex demo


Features

πŸ’Ύ Save & Restore
Every tab, pane, CWD, and command β€” captured and restored by name.

πŸ“¦ 16 Templates
Instant workspace setup β€” splits, IDE layouts, AI pair-programming.

πŸ“ Markdown Blueprints
Obsidian-compatible, version-controlled, shareable workspace definitions.

πŸ€– AI Auto-Detection
15 AI tools detected. Sessions resume mid-conversation automatically.

πŸ” Alfred Integration NEW
Search and launch any workspace from Alfred with one keystroke.

⚑ Auto-Accept NEW
Skip permission prompts on restore for Claude, Codex, OpenCode, and 10 more.


Quick Start

brew install drolosoft/tap/crex       # install
crex setup                            # first-run wizard
crex save my-day                      # snapshot your layout
crex restore my-day                   # bring it all back
crex pop                              # instant workspace picker (Ctrl+G)

crex quick start

Also available via go install github.com/drolosoft/cmux-resurrect/cmd/crex@latest. See Building.


Instant Workspace Picker

Type crex pop or hit Ctrl+G β€” a floating picker with fuzzy search across all layouts, templates, and individual workspaces.

crex pop picker

Tab into any layout to browse its workspaces:

crex pop drill into workspaces


Alfred Integration

Search and restore workspaces directly from Alfred. Type crex + your query β€” every saved workspace is searchable by name.

crex Alfred integration

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.


One Command, Full IDE

crex template use ide

crex template use ide

16 built-in templates β€” from simple splits to monitoring dashboards. See the Template Gallery.


AI Session Resume

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.

Configure auto-accept to skip permission prompts on restore β€” agents start in autonomous mode automatically.


Interactive Shell

crex tui β€” a REPL with browse mode, numbered items, history, and tab completion.

crex interactive shell


Supported Backends

Backend Status Detection
cmux Full support Auto-detected via CMUX_SOCKET_PATH
Ghostty Full support Auto-detected when running

macOS only. Both backends auto-detected β€” same commands, same templates, same Blueprints.


vs cmux native restore

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

Documentation

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

Contributing

Contributions welcome β€” bug fixes, templates, feature ideas. Open an issue or PR.

If crex saves your sessions, a ⭐ helps others discover it.

Support

Buy Me A Coffee


MIT License Β· Forged by Drolosoft Β· Tools we wish existed

About

πŸ”„βœ¨πŸ–₯️ Session persistence for cmux and Ghostty β€” save, restore, and manage your terminal workspaces. Never lose your layout again.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Contributors