marmonitor-tmux

May 18, 2026 ยท View on GitHub

TPM bootstrap plugin for marmonitor.

This plugin is tmux-first and only wires marmonitor into tmux. It assumes marmonitor is already installed and available in PATH.

Install

First install the main CLI:

npm install -g marmonitor

Then add the plugin to ~/.tmux.conf:

set -g @plugin 'mjjo16/marmonitor-tmux'

Reload TPM with prefix + I.

After updating the plugin with prefix + U, re-apply it in the running tmux server if click actions or popup keybindings still look stale:

tmux run-shell ~/.tmux/plugins/marmonitor-tmux/marmonitor.tmux

What It Configures

  • tmux multi-line status when needed
  • status-format[1] with tmux-badges
  • prefix + a attention popup
  • prefix + j jump popup
  • prefix + y copy latest assistant turn from the active AI pane (Claude / Codex / Gemini)
  • prefix + m dock toggle
  • Option+1..5 direct jump

Important Notes

  • This plugin is a bootstrap/install layer, not the canonical cleanup path.
  • Removal and cleanup should be handled by the main marmonitor CLI flow, not by assuming TPM uninstall hooks run automatically.
  • If you previously added manual marmonitor lines to ~/.tmux.conf, remove them to avoid duplicate or conflicting status bars.

Options

set -g @marmonitor-format 'tmux-badges'
set -g @marmonitor-status-line '1'
set -g @marmonitor-attention-key 'a'
set -g @marmonitor-jump-key 'j'
set -g @marmonitor-copy-turn-key 'y'
set -g @marmonitor-dock-key 'm'
set -g @marmonitor-direct-jump 'on'
set -g @marmonitor-interval '5'

Troubleshooting

all ok only, or old compact output:

  • You likely still have an older manual status-format line in ~/.tmux.conf.
  • Check tmux show -gv status-format[1] and make sure it points to marmonitor-tmux/scripts/statusline.sh.

marmonitor not found:

  • Install the main CLI first with npm install -g marmonitor.

prefix + j or statusline click still uses the old behavior after prefix + U:

  • The plugin files were updated, but the running tmux server is still holding the old bindings in memory.
  • Run tmux run-shell ~/.tmux/plugins/marmonitor-tmux/marmonitor.tmux to re-apply the plugin without restarting tmux.

License

MIT