← All projects

Shepherd

Your agents, one keystroke away.

A native macOS terminal for coding with Claude Code and Codex. Shepherd keeps every agent across every project in one place, drops your terminals over any app with a shortcut, and tells you the moment one needs you. Its free iPhone companion lets you answer from anywhere.

Shepherd's window on a MacBook Pro: projects and agents in the sidebar, Claude Code in the terminal and the project's files beside it
Shepherd Companion on iPhone: the Mac live over Wi-Fi, then projects with their sessions
Every project and agent in one window.

Shepherd Mini

Keep your IDE. Lose its terminal.

⌥⇧Space opens Mini over whatever you're in, your IDE included, in Liquid Glass that takes on what's behind it. It's on every Space, even over a full-screen app, so your terminals are always one shortcut away.

Shepherd Mini floating over a full-screen app, with its glass sidebar of projects and agents
Mini over a full-screen app.

Agents

Know the moment an agent needs you.

Shepherd watches the files Claude Code and Codex already keep, so it knows when one is working, finished or waiting on you. No hooks written into your setup and no config edits. Projects sit in groups, each with its sessions and terminals.

One Shepherd tab split into three panes: Claude Code, a test run and a git log
One tab, three panes.

Built in

Files, search, Git and a browser, beside the terminal.

A panel beside the terminal, ⌘1 to ⌘4, holds the project's files, search, saved commands and Git. Edit with syntax colours, folding and a Markdown preview; stage changes from the gutter; commit, branch and push from the commit graph. Your dev server's page opens in the built-in browser by itself.

Shepherd's Git panel: changed files, a commit message and the commit graph
The Git panel and its commit graph.

Shepherd Companion · iPhone

Approve, reply and push from your phone.

The free iPhone app shows every session on your Mac live. Approve or deny an agent from the Lock Screen, read and reply to the whole conversation or flip to its terminal, start a new agent, and commit and push with Git. Your Mac and iPhone talk directly on the same Wi-Fi, or through your private iCloud when you're out. There's no Shepherd server in the middle.

The iPhone Lock Screen with Shepherd's Live Activity: one agent needs you, with Deny and Approve
An agent's conversation on iPhone, with the reply field
The same session flipped to its terminal on iPhone
Lock Screen, a conversation and its terminal.

And the details.

How it's built

Swift, SwiftUI, AppKit.

Shepherd is written in Swift: SwiftUI for the interface, AppKit where the Mac needs it (floating panels over full-screen apps, the global shortcut, the menu bar) and SwiftTerm for the terminal itself. I designed it in Figma and Icon Composer, and built the website, licensing and update feed around it.

  1. Watching agents without hooks

    Session state comes from the files Claude Code and Codex already keep, read as they change, so installing Shepherd never touches a user's tooling.

  2. Mac to iPhone

    Network.framework with TLS on the local network, and CloudKit in the user's private database when away. ActivityKit and WidgetKit on the phone.

  3. Shipping outside the App Store

    Notarised builds, Sparkle with signed appcasts, Stripe licences and a 7-day trial, all handled by sphrd.dev.

Shepherd. Your agents, one keystroke away.

NextWalletaSavings funds for every goal.