minchenlee/flockbook
minchenlee/flockbook has 59 GitHub stars and 8 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 22:05 UTC. Last push 2026-11-13.
Measured star growth
- in 24h
- 0
- in 7 days
- Update delayed
- in 15 days
- Update delayed
- in 1 month
- Update delayed
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
Unofficial native macOS app for Herdr: read, follow and reply to your coding agents (Claude Code, Codex, Cursor, pi) in one place.
Developer ToolsREADME.md
OriginalFlockbook
Unofficial. Flockbook is not affiliated with, endorsed by, or supported by Herdr, Inc. It uses only Herdr's public APIs.
Flockbook is a reading view for your Herdr coding agents. Read what each agent did, see which one needs you, and reply in one place.
It comes in two forms: a layout and mod for the Herdr app, where new work goes, and a native macOS app.
Built with AI. AI coding agents write Flockbook: Claude Code writes the code, and a separate AI reviewer (Codex or Claude) checks each change. A human sets the direction, tests the app, and reviews every change. See How this was built.
Flockbook for the Herdr app

The reading view runs inside the Herdr app window, with no change to the app:
- Chat: each tab with an agent shows as a conversation. Replies are Markdown with code boxes and tables; tool calls fold into short chips.
- Tab bar: one capsule per tab, with its status: working, waiting for you, done or idle.
- Approval and question cards: answer a permission prompt or a question above the reply box.
- Needs you lists every agent that waits. Overview shows every tab as a card.
- Sidebar with your spaces. ⌘B shows and hides it; hidden, it slides out from the window's left edge.
- Terminal: the agent's real terminal is one key away (⌃`).
![]() Approval card: allow or deny a permission prompt above the reply box (1 / 2). | ![]() Needs you: every agent that waits, with its question or approval card. |
![]() Overview by workspace: every tab as a card, in its workspace. | ![]() Reply box: drop files or click + to attach them; ⌘V pastes an image. |
![]() Terminal: ⌃` opens the agent's real terminal over the chat. | ![]() Tab menu: right-click a tab to rename or move it, open its terminal, put it away or close it. |
![]() Floating sidebar: hidden, it slides out when the pointer reaches the window's left edge. | ![]() Overview by status: the agents that need you first, then the rest. |
A small helper, flockbook-modfeed, reads the agents' session logs for the chat. The cards follow the same safety rules as the Mac app: each key checks first that the terminal still shows the same agent and the same prompt, one approval goes out once per prompt, and a reply goes only to the conversation the chat showed.
Install
On macOS or Linux, in one line:
curl -fsSL https://github.com/minchenlee/flockbook/releases/latest/download/install.sh | sh
It downloads the helper for your machine from the latest release, checks it against the release's SHA256SUMS, and runs flockbook-modfeed install. Add -s -- --dry-run after sh to see the plan first.
To look first: download Flockbook-herdr-mod-<version>.zip from the latest release. It has the layout, the mod and the helper for every platform. (It is also listed in the Herdr layout gallery.) Unzip it, then:
./install.sh --dry-run # see what it does; nothing is written
./install.sh
The install never overwrites what you have: if a layout, mod or theme called flockbook is there and it did not put it there, it stops and writes nothing. An older Flockbook that nobody changed (a gallery copy, an older zip) is upgraded in place. herdr-app/README.md has the details, and herdr-app/RECIPE.md describes every part of the mod.
Status: preview. Built and tried on macOS; the helper also runs on Linux (x86_64 and arm64), where the + file dialog is off (drop files or paste an image instead). Agents it reads: Claude Code, Codex, Grok Build, Cursor, pi, oh-my-pi (omp) and Antigravity CLI (agy). omp needs version 18.9 or later: older omp does not report its status (OSC 7501), so Herdr does not list it as an agent and its tab shows the terminal (run omp update).
Flockbook for Mac
A native macOS app (macOS 15 or later) with the same reading view, outside the Herdr app. It also has remote access from your phone over Tailscale, phone notifications, queued messages and an embedded terminal.
Download for macOS · Website · Features, remote access and build
Linux and Windows (in progress)
The Rust code in xplat/ is an early port of Flockbook to Linux and Windows, built with iced. It is not released yet, and it is the reason this repository shows Rust. The macOS app is the Swift code at the repository root and does not use xplat/.
Privacy
Flockbook runs locally. It reads agent session logs on your Mac (~/.claude/projects/, ~/.codex/sessions/, ~/.grok/sessions/, ~/.cursor/projects/, ~/.pi/agent/sessions/, ~/.omp/agent/sessions/, ~/.gemini/antigravity-cli/) and talks to Herdr through its local socket. It has no telemetry. It goes on the network only for the hourly update check (you can turn it off) and, when you turn them on, for remote access over Tailscale or your local network and for phone notifications through the phone's push service. The Herdr app mod and its helper read the same session logs and talk to herdr-core (hc) on your Mac; they go on the network only to check api.github.com once a day for a newer release (turn it off in the mod's Flockbook settings).
How this was built
Flockbook was developed with extensive help from AI: Claude Code (Anthropic) writes most of the code, and a separate AI reviewer (Codex or Claude) checks each change. The repository is open; read the code and judge it on its merits.
About the process
My role is direction, not authorship:
- Product direction: deciding what to build and why
- Testing: using the app every day, finding bugs, checking that features behave
- Review: reading the changes before they land, with an AI review on top for security and correctness
- Measurement: hang and performance fixes are checked with real samples and timings on my own Mac
I'm disclosing this because it's true and because the code should stand on its own. If something is wrong, open an issue.
Contributing
Pull requests are welcome, including ones written with AI tools. Read CONTRIBUTING.md first: it tells you how to build, test, and send a change. Ask questions and suggest features in Discussions. Report security problems as SECURITY.md says.
Contributors
Thanks to everyone who has contributed to Flockbook:
![]() Min-Chen Lee 💻 📖 🎨 🚇 |
![]() Agustín Díaz 💻 📦 |
![]() Cheol Kang 💻 |
![]() Omar Iriskic 💻 |
See CONTRIBUTORS.md for the full list and what each person did.
License
MIT. See LICENSE and THIRD_PARTY_NOTICES.md.











