Changelog

Updates, files and worktrees

• CodeHerd now updates itself. It checks for a new version at launch and once a day, downloads it in the background and offers Restart to Update in the sidebar; it never restarts on its own. Check for Updates… is in the app menu and the command menu (⌘K).
• A Files pane (⇧⌘E, or the folder button in a session’s title bar) shows the folder a session works in as a tree. Open a text file to view, edit and save it (⌘S), handy for filling in a .env yourself. If an agent changes a file while it’s open, nothing is overwritten without asking.
• Overlap warnings now show where two sessions changed the same lines, and which session changed them last, with both versions side by side in the Changes pane. When files overlap but the lines don’t, it says git should merge them cleanly.
• Check together… in the Worktrees dialog merges the worktrees you pick and runs your project’s setup and a check command on the result, to catch changes that merge cleanly but don’t build. Your worktrees are left untouched.
• Start a session in a worktree you already have, one made with git worktree add or left behind by an earlier session: pick Existing worktree in Start a session, or Start a session here in the Worktrees dialog.
• Closing a pane now removes its worktree by default when CodeHerd made it and it has no uncommitted changes, and worktrees whose repository was deleted are cleaned up at launch, so old checkouts stop piling up.
• OpenCode and Muse Code are built in, with detection and install commands. Muse Code sessions also show their name, model and token use in the sidebar, appear in Search sessions and can be resumed.
• Current Claude models show their full 1M-token context window in the context meter.
• Settling a running session no longer asks first, since unsettling resumes the same conversation.
• Snappier terminals: keystrokes echo straight away, and terminals keep fast rendering with many panes open.

CodeHerd 1.0

• Free and Pro. Free runs up to 3 sessions at once; Pro (£10 a month or £96 a year) adds unlimited sessions, Herd HQ, one prompt to several sessions, voice dictation, page annotations and the iOS Simulator pane. Every Mac gets 14 days of Pro, with no card and no account; a Pro licence key works on up to 3 Macs (Settings → Licence).
• Run Claude Code, Codex CLI, Gemini CLI, your login shell or any custom command in parallel panes.
• Projects are folders; each session is a window you can drag into place, split or arrange in a grid, all restored when you come back. Projects show their logo and can be collapsed in the sidebar.
• Optional git worktree per session, with cleanup that never deletes uncommitted work without asking.
• Per-project worktree setup: new worktrees get your .env files copied over and a setup command like pnpm install run before the agent starts.
• Warnings when two sessions’ worktrees change the same files, turning red once their commits would conflict.
• Finds your CLIs from your login shell, even when CodeHerd is opened from Finder.
• Closing a pane, a window or the app stops everything the agent started. Nothing is left running.
• Every session is a named agent (Ada, Bo, Cleo…) with its own colour, the same in its pane, the sidebar, notifications and search.
• Herd HQ (⇧⌘H, Pro): a little 3D campus with a studio for every project and a desk for every agent. See who’s working and who needs you, walk up to anyone to reply, leave a message, start them or take their terminal. Free agents wander the yard until you send them to a project.
• Send one prompt to several sessions at once (⇧⌘P, Pro), to compare how agents handle the same task.
• An in-app browser beside your sessions, per project, with full screen and responsive device sizes. Links you click open there, and dev servers a session starts are spotted so you can open them in one click. With Pro, mark up a page with boxes, arrows and notes and attach it to an agent’s prompt (⇧⌘A).
• Voice dictation (Pro): hold Right ⌥ and speak, and your words are typed into the focused session’s prompt. Speech is transcribed on your Mac by whisper.cpp; the speech model downloads once, when you turn dictation on.
• The iOS Simulator beside your sessions (⇧⌘M, Pro): boot a simulator, see it live and use it with the mouse and keyboard.
• Queue follow-up prompts for a session (⌥⌘↩): each is sent when the agent stops and waits for you.
• Search every project’s sessions by what was said in them (⇧⌘F): Claude Code, Codex and Gemini conversations, and session titles.
• See how full each agent’s context window is, and how many tokens it has used, with a warning when it’s nearly full.
• Saved prompts (⌘P): a searchable list of reusable prompts with {file}, {branch} or any {placeholder} filled in as you insert them.
• A command menu (⌘K) for every action, and keyboard shortcuts for splitting, focusing, cycling and zooming panes.
• Find in the terminal (⌘F) and bigger or smaller terminal text (⌘= / ⌘- / ⌘0).
• Rename a session by double-clicking its title; reorder projects by dragging them or from their menu.
• Opt-in notifications when an agent you can’t see finishes or seems to be waiting for you, plus an in-app “waiting for you” indicator.
• Clickable links in terminal output; links to unknown sites ask before opening.
• Light and dark themes, configurable terminal font, size and scrollback.