projmux

npm install -g projmux
projmux shell

Keys

• Alt-1 projects
• Alt-2 notifications
• Alt-3 recent windows
• Alt-4 resume an AI session
• Alt-5 settings
• Alt-7 new AI split

Alt-1–Alt-5 work with no configuration. See Terminal Keybindings to remap them.

Pick up a conversation

Alt-4 lists your Codex, Claude Code, and Antigravity sessions. Choose one and it opens where you left it, as the same conversation.

Get called back

Agent permission requests and completions land in one grouped inbox. Alt-2 takes you to the pane that is waiting.

Run agents in parallel

Keep a shell, Codex, and Claude Code in the same window. Agents can open other agents through the same CLI you use:

projmux create claude --project mobile-client -- "Draft the migration plan."

Templates and naming conventions are in AI Agent Shortcuts.

Also in the app

• Live per-project, per-window, and per-pane CPU/RSS in the Resource Inspector.
• Registry-based Continue project and Clear layout and open in Project Startup.
• Search roots, keybindings, and updates in Settings.

Requirements

Node.js and npm, plus tmux 3.4 or newer. Run projmux doctor for read-only local diagnostics, or Troubleshooting if the app will not start.

Docs

Install · Configuration · Upgrading · CLI Reference · CLI Task Guide · Statusbar · Hooks · Usage tracking · Operational Diagnostics

Development

make build
make fmt
make fix
make test

See Testing, Architecture, and Repo Layout.

License

MIT. See LICENSE.