New v0.12.0 — the agent’s notes stay in the chat →

Your coding agents,
minus the mess.

Shep is a small, free Mac app that keeps Claude Code, Codex, and friends in one tidy window. Pick a project, pick an agent, get back to building. That’s pretty much it.

New agent
shep-website

New agent

Run as
Permissions

Chat and terminal ready

Sound familiar?

Nine terminal tabs. Three agents. One of them has been waiting on you for twenty minutes.

Shep is one window that knows about your projects and your agents, and keeps out of the way the rest of the time. No new AI to learn. No account. Just the stuff you actually reach for, right where you left it.

The sidebar

See who needs you, at a glance.

Every agent you start lands in the sidebar with a tiny status light. Spinning means it’s working. Yellow means it’s waiting on you. Purple means it’s done and ready for a look.

That’s the whole system. You’ll get it in about five seconds.

Agents4
Add a dark mode toggle recipe-box Working
Write tests for checkout tiny-shop Needs you
Fix the mobile nav portfolio Done
Tidy up the README tiny-shop Working
Chat or terminal

Chat or terminal. Your call.

Some days you want a clean chat, with diffs and permission prompts that don’t scroll away. Some days you want the real CLI. Shep does both, for the same agents, in the same project.

Dark mode toggle
pnpm dev
Can you add a dark mode toggle to the header? Keep it simple.
Worked for 41s · 4 steps
Readsrc/Header.tsx
Editedsrc/Header.tsx+8 −1
Editedsrc/theme.css+24
Done. There’s a little sun/moon button in the header now. It remembers your choice and follows your system setting by default. Want me to run the build to make sure nothing broke?
Needs you
Run pnpm build
Reply to Claude…
Sonnet Ask first
Changes

See what actually changed.

Hit ⌘G and you get the files your agents touched, with the diffs. It’s not a full git client and doesn’t want to be. It’s just enough to know what happened before you commit.

dark-mode
3 files changed +53 −1
M Header.tsx src +8 −1
M theme.css src +24
N useTheme.ts src/hooks +21
src/Header.tsx
1 import { Link } from './Link';
2 + import { useTheme } from './hooks/useTheme';
3
4 export function Header() {
5 + const { theme, toggle } = useTheme();
6 +
7 return (
8 <header className="header">
9 <Link href="/">Recipe Box</Link>
10 − <nav className="nav" />
10 + <nav className="nav">
11 + <button onClick={toggle}>
12 + {theme === 'dark' ? '☀︎' : '☾'}
13 + </button>
14 + </nav>
15 </header>
16 );
17 }
Usage

Know before you hit the wall.

Nothing kills a good session like a surprise rate limit. Shep shows how much of each plan you’ve used and when it resets, right in the sidebar.

The little tick on each bar shows how far into the window you are, so you can tell if you’re running hot.

Usage.

Limits
Codex Weekly 72% Resets in 6d 4h
Claude 5 hour 31% Resets in 2h 51m
Antigravity Weekly 7% Resets in 3d 16h
Muse 5 hour 18% Resets in 3h 12m
Activity 602M tokens · 44 sessions

And a few little things.

Small on their own. Nice to have together.

dev serverpnpm dev autostart

Commands

Save your dev server, tests, and watchers once. Start them with a click, or let them start themselves.

rec ⌘P
recipe-box

Jump anywhere

The sidebar shows what you’re working on. Everything else is one ⌘P away.

Fix mobile nav2h ago
Stripe webhooksTue

History

Close a session by accident? Find it in History and pick up where you left off.

Add recipe search
Dark mode toggle

To-dos

A simple board backed by your project’s TODO.md. Your agents can keep it up to date too.

A small opinion

Your editor wasn’t built for this.

VS Code is a great editor. It was also designed for a world where you typed every line yourself, so everything is organized around files: a file tree, a wall of tabs, a minimap. The agent gets squeezed into a side panel or a terminal at the bottom.

These days the agent does most of the typing. Your job is to point it somewhere, answer when it needs you, and check what changed. Shep is built around that job instead of around files.

Still want to poke at something by hand? ⌘E opens the project in your editor. That’s what it’s for now.

Claude Code Chat & terminal
Codex Chat & terminal
Cursor Chat & terminal
Antigravity Chat & terminal
Open Code Chat & terminal
pi Chat & terminal
Muse Code Chat & terminal
Whatever ships next Probably next month
Another one

Don’t marry one model.

Every few months someone ships a model that’s better at something. Last month’s favorite is this month’s runner-up. If your whole workflow lives inside one company’s app, switching means starting over.

Shep runs seven agents side by side, in the same projects, with the same sidebar. When something better comes out, open a new tab and try it. Out of Claude for the week? Hand the task to Codex and keep going.

The next best model is one release away. Be ready for it.

Each agent runs its own CLI on your Mac, signed in with your own account.

What Shep isn’t.

Most of what makes Shep nice is the stuff we left out.

It’s not a cloud thing.

Shep itself runs entirely on your Mac, in your own folders. No Shep servers, no syncing, nothing to log into.

It’s not another AI.

There’s no Shep model and nothing new to pay for. It runs the agents you already have.

It’s not a subscription.

Free, MIT licensed, no sign-up, no tracking. It’s just an app on your Mac.

Built with Rust and Tauri, so it’s a ~14 MB download that opens fast and stays light while it runs.

Give it a try.

It’s free and it’s small. If it’s not for you, dragging it to the Trash takes about a second. No hard feelings.

Download Shep for Mac

v0.12.0 · macOS on Apple Silicon · What’s new

Questions, ideas, or something broke? Come say hi on Discord.