Shepherd

A workspace made for agents

Give every agent
room to work.

Run Codex and Claude across tabs and panes. See what is working, what needs you, and where every task left off.

See how it works
Shepherd
This Mac3 workspaces · 5 agents
Home Macgojunseo@100.102…
WORKSPACES
shepherd
Tab1
AGENT MONITOR
shepherd
auth-refactor

[LOCAL] dev@macbook ~/shepherd ▯ feature/agent-workspace

❯❯❯ codex --yolo

›_ OpenAI Codex (v0.147.0)

model: gpt-5.6-sol low /model to change

directory: ~/shepherd

permissions: YOLO mode

• I’ll inspect the OAuth callback flow and its tests first.

› Read src/main/oauth-callback.ts
› Search "handleCallback" in src
› Run pnpm test --filter oauth

◐ Working (18s · esc to interrupt)

Add tests for expired callback state
shepherd feature/agent-workspace/Users/dev/shepherdRoutes 1  ⌁ CPU 12% · RAM 58%
WORKTREE
RepositoryWorktree12

The perfect terminal
for agents.

Split work across panes without losing the terminal underneath. Shepherd keeps every process running when the app closes, then restores the same tabs, panes, and sessions when you reconnect.

  • Split panes for parallel work
  • Processes survive app restarts
  • Reconnect to the same live session
Simplified visual for demonstration. The actual app interface may differ.
Agent MonitorIn Shepherd
auth-refactorCodex · working
dashboardClaude Code · idle
integration-testsCodex · completed unread
ϟ Live Agent Monitor1 machine   ×
This MacDone 1
Simplified visual for demonstration. The actual app interface may differ.

Know where every agent stands.

A small, always-available view of every active task. Jump between Codex and Claude without hunting through windows.

  • Working right now
  • Waiting for your input
  • Completed since you looked

Resume the context.
See every change.

Return to an agent session with its exact tab and pane, then inspect the files and diffs it created without leaving Shepherd.

RESUME AGENTDashboard implementation

Claude Code · feature/usage-dashboard

Resume ↗
AGENT CHANGES4 files changed

agent-monitor.tsx  +42 −8

View files ↗
Simplified visual for demonstration. The actual app interface may differ.

The small things,
already in reach.

Open a file, inspect the exact diff, or type directly into the terminal without leaving the workspace.

WORKTREE
app.tsxsrc / renderer / app.tsx
1import { AgentMonitor } from './agent-monitor';
2
3export function App() {
4  return <AgentMonitor />;
5}
Simplified visual for demonstration. The actual app interface may differ.

Let agents operate
the workspace.

The Shepherd Plugin gives Codex and Claude control of the terminal workspace. An agent can create the layout it needs, delegate work, and verify the result without asking you to arrange every pane by hand.

01
ASK IN YOUR AGENTDescribe the work, not the terminal setup.

“Update the API tests in a sub-agent and run the test suite alongside it.”

Update the API tests, then verify them in a separate terminal.

02
SHEPHERD PLUGINThe agent builds its own workspace.

It opens a pane, creates a tab, starts another agent, and sends commands or follow-up input.

create_panecreate_tabsend_inputread_output
03
WORK CONTINUES IN PARALLELWatch the agent work and inspect the result.

The sub-agent edits the code while a neighboring terminal runs the tests. Every pane stays available to you.

SUB-AGENT Updating API tests
TERMINAL❯ pnpm test42 tests passed
Simplified visual for demonstration. The actual app interface may differ.

Well designed for
remote development.

Connect to a remote machine without giving up the local workflow. Routes bring services bound to remote localhost back to your Mac, while Files lets you browse and open remote project files as naturally as local ones.

ShepherdLocal Mac
SSH · Routessecure connection
gpu-builderremote serverlocalhost:3000
ON THE SERVERlocalhost:3000
Routes 1
localhost:43120
CHROME · FORWARDED TO YOUR MACDashboard is running

The same site from gpu-builder:3000

FILES gpu-builder
srcremote
apps
services
package.json
README.md

FILES Browse, open, and edit files on gpu-builder as if they were local.

Simplified visual for demonstration. The actual app interface may differ.

Keep the work moving.

Download the signed and notarized macOS app.