Skip to content

Agent Flock 0.1.0

Latest

Choose a tag to compare

@Akash-nath29 Akash-nath29 released this 17 Nov 00:37

Agent Flock 0.1.0

Released 2026-11-17 · first public release · alpha

Agent Flock puts a Mac-style notch at the top of your Windows screen that shows what every Claude Code and Codex agent is doing, even after you close the terminal or editor that started it.

Highlights

  • A notch that stays out of the way. It shows a one-line summary ("2 working", "1 needs you") and one dot per agent, coloured by state. When no agent is working or waiting, it folds into a thin line at the top edge. Hover to unfold it.
  • Know when an agent needs you. A pulsing amber dot and a short banner tell you the moment an agent waits for a permission or an answer. Banners also announce agents that finish, fail or stop.
  • One click to the agent. Click an agent in the list, the banner or the hover peek, and its terminal, editor or app window comes to the front.
  • Every agent at a glance. Click the notch to open the list: each agent's name, source (Claude Code or Codex), what it is doing right now ("Editing auth.ts", "Running npm test"), and a progress bar.
  • Honest progress. The percentage comes from the agent's own task list and stays below 100% until the agent says it is done. Without a task list, the bar shows activity instead of a made-up number.
  • Tidy up with a swipe. Dismiss a finished agent with ×, or clear every finished agent at once.

What's included

  • Claude Code support: the CLI, the VS Code extension, the desktop app and headless claude -p.
  • Codex support: the CLI and the Codex app, through Codex hooks.
  • One-click setup: adds Agent Flock's hooks to ~/.claude/settings.json and ~/.codex/hooks.json, keeps your other settings, and saves a backup first. Remove hooks takes them out again.
  • Six states: working (blue), needs you (amber), done (green), failed or stopped (red), and idle (grey).
  • Crash detection: an agent whose process exits mid-task turns red as Stopped within about 5 seconds.
  • Out of your way: hidden while a fullscreen app (video, game, slideshow) is in front. The notch never covers more of the screen than its own shape.
  • Naming: agents take their name from AGENTFLOCK_NAME, the session title, the first prompt or the folder name, in that order.
  • App basics: a tray icon and right-click menu (Open, Show or hide the notch, Set up hooks, Remove hooks, Quit), and a single running copy.
  • Private by design: everything stays on your machine, with no network calls, no telemetry and no account.

Small and light: the installer is 1.2 MB. On one Windows 11 test machine the app used about 110–125 MB of memory, and the hook took about 23 ms per agent event and runs in the background, so agents don't wait on it while they work.

Install

  1. Download Agent Flock_0.1.0_x64-setup.exe below and run it. It installs for your user only; no admin rights needed.
  2. The notch appears at the top of your screen reading Set up Agent Flock. Click it, then click Set up.
  3. For Codex, approve the new hooks once: type /hooks in the Codex CLI, or open Settings → Hooks in the Codex app.

Agents you start from then on show up automatically.

Requirements: Windows 11 (x64). Claude Code with hook support (tested with 2.1.325) and/or Codex with hooks enabled (configured against 0.141.0).

SHA-256 of Agent Flock_0.1.0_x64-setup.exe:

b2b7a0977b9ad767044ab9b4e9ac2c433cd836537e322ffbe7a84aef316c8857

Check it in PowerShell with Get-FileHash ".\Agent Flock_0.1.0_x64-setup.exe".

Known issues

  • Unsigned installer. Windows SmartScreen may warn you. Click More info, then Run anyway.
  • Codex is less tested than Claude Code. Codex support follows Codex's documented hooks but has not yet been verified end to end. If Codex agents don't appear, check that you approved the hooks in /hooks.
  • Codex app sessions share one process. A Codex app session that ends without saying so shows as stopped only when the whole app quits.
  • Interrupting Claude Code with Esc. The agent stays marked as working until its next turn, because Claude Code sends no event for an interrupt.
  • Jumping to an agent raises its window, not its tab. With two agents in one Windows Terminal or VS Code window, you land on the window and pick the tab yourself.
  • Agents with no window of their own, such as headless claude -p runs, bring up the window of whatever started them.
  • Moving the app. If you reinstall Agent Flock somewhere else, open it and click Update hooks so agents report to the new location. Codex then asks you to approve the changed hooks again.

Feedback

Found a bug or have an idea? Open an issue.