Tmux Grimoire

Summonable popup shells (shpells) for tmux: customizable, scriptable and driven by keybindings.

Installation

Run the interactive installer:

curl -fsSL https://raw.githubusercontent.com/navahas/tmux-grimoire/main/install.sh | bash

The script will detect your setup, configure keybindings, and add example shpells to ~/.tmux.conf.

Prefer manual setup? See docs/INSTALLATION.md

Quick Reference

Default keybindings:

Keybind	Action
prefix + f	Open the main shpell, or close any active one
prefix + F	Summon a new ephemeral shpell
prefix + C	Close and dismiss the current shpell
prefix + H	Reveal the Grimoire welcome banner

Awaken the Grimoire

After installation, your ~/.tmux.conf will include example shpells (commented out). Uncomment and customize them to shape your workflow.

Documentation:

• Configuration | Adjust colors, size and position
• Custom Shpells | Create custom keybindings and use the --replay mode
• Advanced Usage | Manage windows, splits and integrations

---

License

MIT