Skip to content

Pet

pet working at the desk

A small ASCII cat lives in a 5-row band between the agent list and the bottom panel. Its state is driven by the running-agent count — the same count surfaced in the sidebar’s status filter row. The pet is opt-in: enable it with set -g @sidebar_pet on (see tmux options).

pet sitting idle at home

When no agent is running, the cat sits at the left edge of the band. Periodically it plays a subtle motion — a blink, a wave, or a small jump — seeded fresh each cycle so the timing isn’t perfectly regular.

pet walking across the band

When the running-agent count crosses 0 → ≥1 (or back), the cat walks between its home position and the desk. The walk uses mirrored sprites for both directions; the docs treat both as one Walking state.

pet working at the desk

While at least one agent is running, the cat sits at the desk shuffling papers. The paper stack grows with the running-agent count: 1 paper at 1 running agent, 2 papers at 2-3, capped at 2 for 4 or more.