wezterm-agent-deck

# WezTerm Agent Deck

Monitor Claude Code agents across terminal panes with Agent Deck plugin.

## Installation

```lua
local agent_deck = wezterm.plugin.require('https://github.com/Eric162/wezterm-agent-deck')
```

## Configuration

```lua
agent_deck.apply_to_config(config, {
    update_interval = 500,      -- ms between status checks
    cooldown_ms = 2000,         -- ms before marking agent as idle
    max_lines = 100,            -- lines to scan for status

    colors = {
        working = '#a6e3a1',    -- green
        waiting = '#f9e2af',    -- yellow
        idle = '#89b4fa',       -- blue
        inactive = '#6c7086',   -- gray
    },

    icons = { style = 'nerd' },

    notifications = {
        enabled = true,
        on_waiting = true,      -- notify when agent needs input
        timeout_ms = 4000,
        sound = true,
    },

    tab_title = { enabled = true },
    right_status = { enabled = false },  -- Use custom status bar
})
```

## Agent Status States

| Status | Color | Meaning |
|--------|-------|---------|
| working | green | Agent is actively processing |
| waiting | yellow | Agent needs user input |
| idle | blue | Agent is idle (after cooldown) |
| inactive | gray | No agent detected in pane |

## API: Get Agent State

```lua
local agent_state = agent_deck.get_agent_state(pane.pane_id)
local status = agent_state and agent_state.status or 'inactive'
```

Use in tab formatting:
```lua
wezterm.on('format-tab-title', function(tab, tabs, panes, cfg, hover, max_width)
    local pane = tab.active_pane
    local agent_state = agent_deck.get_agent_state(pane.pane_id)
    local status = agent_state and agent_state.status or 'inactive'

    local status_dot = ''
    if status == 'working' then
        status_dot = '●'  -- green
    elseif status == 'waiting' then
        status_dot = '●'  -- yellow
    elseif status == 'idle' then
        status_dot = '○'  -- blue
    end
    -- ... rest of tab formatting
end)
```

## API: Count Agents

```lua
if agen