geppettoA native home for your AI coding agents.
geppetto gives Claude Code a real macOS interface — native chat, tool-call cards, and permission sheets, or the real CLI in an embedded terminal. Run several agents in parallel, each in its own project, from one sidebar — and drive them from your phone when you step away.
macOS 14+ · Apple Silicon · free
What it does
Parallel sessions
Run many agents at once, one per tab, each with its own working directory. Switch with ⌘1–9.
Native chat UI
Streaming replies, collapsible tool-call cards, inline diffs, and thinking blocks — rendered natively, no ANSI parsing.
Terminal or native
Each session runs the real Claude CLI in an embedded terminal, or speaks ACP and renders as native UI. Your choice, per session.
Control from your phone
Attach to any session from the geppetto companion app over your private Tailscale network — a live terminal mirror, file uploads, and a QR to pair. Get a push when an agent needs you.
Permission sheets
Tool calls that need approval surface as native sheets, so you stay in control of what the agent does.
Isolated worktrees
Open a second agent on the same project in its own git worktree so two agents never clobber each other's work.
Auto-updates
Developer-ID signed, notarized, and updated in place via Sparkle. Always on the latest build.
Why geppetto
The raw agent CLI
Powerful, but it's one terminal, one agent, and a wall of text. No parallel sessions, no native tool-call UI, no way to check in from your phone.
A terminal multiplexer
tmux/iTerm panes give you parallelism but no structured chat, diffs, or permission control — and no per-session project management.
Web-based agent UIs
They route your code and credentials through a remote server. geppetto runs locally against your real Claude Code auth and filesystem — nothing leaves your Mac (the phone attaches over your own tailnet, never the public internet).
FAQ
What agents does it support?+
Claude Code. Each session runs the real Claude CLI in an embedded terminal, or speaks ACP and renders as native chat (npx @agentclientprotocol/claude-agent-acp) — your choice, per session.
What do I need?+
An Apple Silicon Mac on macOS 14 (Sonoma) or later, Node on your PATH (for the Claude bridge), and standard Claude Code auth (~/.claude/) — no separate login.
Can I use it from my phone?+
Yes. The companion geppetto app attaches to your terminal sessions over your private Tailscale network (never the public internet) — a live terminal mirror with file uploads and localhost preview. Scan a QR in Settings ▸ Remote to pair, and get a push when an agent needs you.
Is it safe?+
geppetto is Developer ID signed and notarized by Apple, and runs entirely on your machine against your own agent credentials.
How do updates work?+
geppetto checks for updates via Sparkle and installs them in place — signed and verified. You can also trigger a check from the geppetto menu.
Made by
I'm Robert, a product & brand designer in Brooklyn. geppetto is a tool I built to run my own coding agents — if it's useful to you, a coffee is always appreciated.