All your coding agents in one Mac window, and the one that needs you is amber

Description and use

Shepi consolidates Herdr agents into a single macOS window, highlights those awaiting approval in amber, and provides shortcuts and UI to streamline remote agent management.

Problem

Managing multiple coding agents across a Mac and servers becomes tedious when each agent stops to ask for approval before deployment, requiring manual inspection of terminal output to identify which agent is waiting.

Outcome

Shepi reduces the time spent locating which agent needs approval from hours to seconds, consolidates remote server agents into a single sidebar, and provides intuitive keyboard shortcuts and UI cues (amber highlight) to streamline workflow.

Workflow

• 1. Install Shepi and connect it to Herdr.
• 2. Add servers via SSH in the sidebar or Settings.
• 3. Agents run normally; when one stops, its pane header, sidebar entry, and status line turn amber.
• 4. Use ⌃B a or the Review button to jump to the waiting agent.
• 5. Agents can ask questions with shepi-agent ask, presenting options as buttons.
• 6. Use ⌘F to search across agents, spaces, panes, and machines.
• 7. Drag panes to rearrange layout; use prefixes like =, z, d for layout and file operations.
• 8. Leave Shepi open; waiting agents appear in the inbox next to Find and the Dock icon shows counts.

Evidence

One of your agents stopped to ask whether it could deploy, sometime in the last hour.

Source

Herdr already knows which agent is working, waiting, done or idle, and it keeps them all alive whether or not anyone is looking.

Source

Shepi is a native Mac client for Herdr: every agent in a real terminal, on this Mac or your servers, with the one that needs you in amber.

Source

When an agent stops to ask, it turns amber in three places at once: the sidebar, its pane header and the status line.

Source

The same small plugin lets an agent open a page or a file on your Mac, report its progress under its own name in the sidebar, and open a pane beside itself to run tests or a dev server, marked as opened by it and never taking your keyboard.

Source

Add any machine you reach over SSH from the sidebar or Settings › Machines, as you@server or a host from ~/.ssh/config.

Source

⌘F searches agents, spaces, panes, machines and the recent output of every pane, local and over SSH.

Source

Leave Shepi open and walk away. Every agent that needed you, finished or asked a question meanwhile waits in the inbox next to Find, one entry per pane, until you look at that pane.

Source