Tmux Agent Pulse — Development skill for Claude Code

tmux-agent-pulse

**English** | [한국어](README.ko.md)

AI CLI status notifications for tmux. Supports Claude Code, Codex CLI, and Gemini CLI out of the box.

Shows status icons on tmux window names when AI CLI tools are active:

• 💬 — AI is responding (output detected for 2.5s+)
• ❓ — AI is waiting for user input (permission prompt detected)
• ✅ — AI finished responding (output stopped)
• Icons auto-clear when you switch to the window

Demo


Why tmux-agent-pulse?

• Zero configuration — Works out of the box. No hooks, no API keys, no per-tool setup. Just install and go.
• Simple & unobtrusive — A single icon on the window name. No status bar clutter, no color changes, no visual noise.

Other plugins (e.g. tmux-agent-status, tmux-agent-indicator) require Claude Code hooks or tool-specific configuration. tmux-agent-pulse detects any supported CLI tool automatically via process tree inspection.

How it works

A background daemon polls all tmux panes every 0.5s. It inspects child processes of each pane (`ps -eo pid,ppid,args`) to detect AI CLI tools, then compares output snapshots to track activity changes. No hooks or configuration needed.

Install

Requirements

• tmux 3.0+
• TPM

**Note:** The plugin automatically enables the tmux status bar (`set -g status on`) on load, as it's required to display window name icons.

With TPM

Add to `~/.tmux.conf`:

set -g @plugin 'devbrother2024/tmux-agent-pulse'

Then press `prefix + I` to install.

Manual

git clone https://github.com/devbrother2024/tmux-agent-pulse ~/.tmux/plugins/tmux-agent-pulse

Add to `~/.tmux.conf`:

run-shell ~/.tmux/plugins/tmux-agent-pulse/agent-pulse.tmux

Configuration

Optional environment variables (set before the plugin loads):

Variable	Default	Description
AGENT_PULSE_INTERVAL	`0.