Skip to content

v0.2.0

Choose a tag to compare

@github-actions github-actions released this 16 Oct 15:42
· 254 commits to main since this release

What's New in v0.2.0

Flockbook now works from your phone. Read your agents, answer them, and get a notification when one needs you, from an iPhone, iPad or Android phone over your own Tailscale network. On the Mac, long conversations no longer stall, you can select and copy any message, and the app updates itself from now on.

✨ New Features

Your agents on your phone

  • Remote access: Open your agents in the phone's browser and add the page to the Home Screen. You see the agent list, each conversation and its state, with the Mac app's look. It is off by default. Turn it on in Settings > Remote access; a checklist walks you through Tailscale Serve and pairing by QR code. Only your own Tailscale devices can reach it, never the internet. Requires Tailscale on the Mac and the phone.
  • Reply, Allow and answer from the phone: A paired phone can read. Turn on input for it in Devices to send messages, Allow or Deny approvals, and answer questions with options. Codex questions work as is. Claude Code questions need a hook that you install from Settings (it shows the exact line it adds to ~/.claude/settings.json, and Uninstall removes only that line). If the question on screen does not match exactly, the phone tells you to answer on the Mac and sends nothing.
  • Push notifications: Tap Notify me on the phone to get a notification when an agent needs you or finishes. Tap the notification to open that agent. By default, notifications are sent only when you are away from the Mac (no input for 2 minutes, or the screen is locked); you can change this and turn off "done" notifications in Settings > Remote access > Phone notifications, where you also see each phone, send a test, or remove it. Notifications carry the agent's name and state, never conversation text. At most one per agent per 2 minutes and 6 per minute; extra ones are summed up as "+N more". iPhone and iPad need iOS/iPadOS 16.4 or later and the page added to the Home Screen.
  • Notifications from your agents: flockbook-notify "Title" ["Body"] lets an agent or a script send its own phone notification through the running app. Settings shows the command's path; Flockbook does not change your PATH.
  • Send images from the phone: Tap + to attach up to 4 photos (10 MB each) from the camera or library. The Mac re-encodes each image and drops location and camera data before the agent gets it.
  • Full Markdown on the phone: Headings, lists, task lists, quotes, code blocks and tables show as they do on the Mac. Wide tables scroll sideways.
  • Phone message box: One line is a pill; it grows for more lines or images. You can keep typing while an agent works or compacts its context.

Conversations on the Mac

  • Select and copy any message: Drag across paragraphs, lists, code and tables in one message, then press ⌘C. Copy gives plain text. Code blocks have Copy Code. VoiceOver users can use the Select Text action.
  • Messages you sent while Claude Code was working: A message you typed during a turn now shows in the conversation, on the Mac and on the phone.

Updates

  • Automatic updates: Once a day Flockbook checks for a new version and installs it only after you agree. Turn the check off in Settings, or use Flockbook > Check for Updates…. Versions 0.1.2 and earlier have no updater: install 0.2.0 by hand once.

🚀 Improvements

  • Long conversations stay fast: A conversation opens with its newest 100 messages. Show earlier adds 100 more, up to 150 at once; past that, Jump to latest brings you back to the newest. Before, a long session could freeze the window for seconds.
  • First run says what is wrong: If Herdr is not installed, not running, or its socket is closed to you, Flockbook says which one and shows the next step (the install page, or the command to start it, ready to copy) with Try Again, instead of "Connecting…" forever.
  • Settings is a page in the main window, not a separate window.
  • Approval notifications say what they approve.
  • Scroll bars follow your system setting, also with a mouse attached, and stay thin.
  • The website and README say plainly that AI agents build Flockbook, with a human reviewing every change.

🐛 Bug Fixes

  • An approval card whose log lagged behind the screen now sends Allow, instead of nothing.
  • An image pasted on the Mac reaches Claude Code as an image, not as a plain file path.

📦 Installation

Download: Flockbook-0.2.0.dmg (or .zip) below. Check it against SHA256SUMS.

Signed with a Developer ID and notarized by Apple.

Requires macOS 26 or later and a running Herdr. Universal (Apple silicon + Intel).
Phone features need Tailscale on the Mac and the phone.

Unofficial: not affiliated with, endorsed by, or supported by Herdr, Inc.


Full Changelog: v0.1.2...v0.2.0