Agent Flock

Every coding agent, one glance away.

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, and tells you the moment one needs you. Even after you close the terminal that started it.

v0.1.0 alpha · 1.2 MB · Windows 11 x64 · Free and open source

The black notch at the top of this page is a live demo with scripted agents. Click it, then click an agent to bring its window forward.

invoice.ts · billing
  1. import { Invoice } from './types';
  2. import { toCsv } from './csv';
  3. import { renderPdf } from './pdf';
  4. export function exportInvoices(
  5.   invoices: Invoice[],
  6.   format: 'csv' | 'pdf',
  7. ) {
  8.   if (format === 'csv') {
  9.     return toCsv(invoices, COLUMNS);
  10.   }
  11.   return renderPdf(invoices, { size: 'A4' });
  12. }
  13. export const COLUMNS = ['id', 'customer', 'total'];
Codex Editing invoice.ts
auth-service

PS C:\dev\auth-service> claude

> Fix the token refresh race in auth/refresh.ts

Read auth/refresh.ts

Edit auth/refresh.ts +14 −6

Bash command

npm test -- refresh

Do you want to proceed?

› Yes

  No

Bash npm test -- refresh

  PASS test/refresh.test.ts (42 tests)

Fixed the refresh race. 42 tests pass.

api

PS C:\dev\api> $env:AGENTFLOCK_NAME = "worker-3"; claude

Running npm test · 2 subagents

  PASS src/users/users.test.ts

  PASS src/orders/orders.test.ts

  PASS src/billing/tax.test.ts

  RUNS src/billing/invoice.test.ts

Small at rest. Loud only when something needs you.

Windows puts title bars and tabs at the top of the screen, so the notch stays unfolded only while an agent is working or waiting on you. Scroll, and watch the one at the top of this page.

A thin black line

Nothing is working or waiting, so the notch folds into a 72 × 6 px lip and your title bars and tabs stay clickable. Hover it to unfold.

One dot per agent

“2 working” and a dot for each agent, coloured by state: blue working, green done, red failed or stopped.

A pulsing amber dot

An agent is waiting for your permission or an answer. You see it from across the screen, without opening anything.

A wide banner

When an agent needs you, fails, stops or finishes, the notch says so for four seconds. Click it to go straight to that agent’s window.

Every agent, one click

Click the notch for the list: each agent’s name, where it runs, what it is doing right now and how far along it is. Esc closes it.

Progress it doesn’t make up.

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 number.

Every state has a word and an icon as well as a colour, so you never have to tell amber from red at a glance. An agent whose process dies mid-task turns red as Stopped within about five seconds.

Add invoice exportCodexnow
Editing invoice.ts
60%
worker-3Claude Codenow
Running npm test · 2 subagents
Working
Fix the token refresh raceClaude Code2 min
Needs permission: Bash
Needs you
Update READMEClaude Code4 min
Updated the install steps
100%
Refactor billing serviceCodex10 min
stream disconnected before completion
Failed
Migrate config loaderClaude Code12 min
Process exited mid-task
Stopped
AgentFlockCodexnow
Waiting for a prompt
Idle
Sample agents, one for each state.

It reads the agents’ own hooks.

So it reports what an agent is actually doing (the tool it runs, the permission it waits on, the moment it finishes or its process dies) instead of guessing from windows or logs. And it keeps watching after you close the editor or terminal that started the agent.

  1. Claude Code, Codex fire a hook on each lifecycle event
  2. flock-hook.exe about 23 ms per event, in the background, so agents never wait on it
  3. %LOCALAPPDATA%\AgentFlock\events one JSON Lines file per session, expired 24 hours after its last event
  4. The notch turns each event into a state, a dot and a line of status

One click to connect

On first launch the notch reads Set up Agent Flock. Click it, then Set up. It adds one hook entry per event to ~/.claude/settings.json and creates ~/.codex/hooks.json. Your other settings stay as they are, and a backup is saved first.

To undo it, right-click the notch and choose Remove hooks.

One entry in ~/.claude/settings.json
{
  "type": "command",
  "command": "C:\\Users\\you\\AppData\\Local\\Agent Flock\\flock-hook.exe",
  "args": ["agentflock:claude"],
  "async": true
}

Everything stays on your machine.

No network calls, no telemetry and no account.

Agent Flock only watches. It never approves, sends or stops anything in an agent, and it never slows one down.

Works with the agents you already run.

Claude Code

  • the CLI
  • the VS Code extension
  • the desktop app
  • headless claude -p and orchestrated workers

Codex

  • the CLI
  • the Codex app
  • through Codex hooks, trusted once in /hooks

Name an agent

Agents take their name from AGENTFLOCK_NAME, the session title, the first prompt or the folder name, in that order. Try it: the notch renames worker-3.

Install in three steps.

  1. Download and run the installer

    It installs for your user only. No admin rights.

  2. Click the notch, then Set up

    Agent Flock adds its hooks to Claude Code and Codex and backs up your settings first.

  3. Trust the hooks in Codex

    Type /hooks in the Codex CLI, or open Settings → Hooks in the Codex app. Claude Code needs nothing more.

Agents you start from then on show up on their own.

Download for Windows
File
Agent.Flock_0.1.0_x64-setup.exe
Size
1.2 MB
Needs
Windows 11 x64, plus Claude Code with hook support or Codex with hooks enabled
SHA-256 b2b7a0977b9ad767044ab9b4e9ac2c433cd836537e322ffbe7a84aef316c8857

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

Before you install

  • It’s an alpha. 0.1.0 is the first public release.
  • The installer isn’t signed yet. Windows SmartScreen may warn you: click More info, then Run anyway.
  • Codex is less tested than Claude Code. If Codex agents don’t appear, check that you approved the hooks in /hooks.
  • Jumping to an agent raises its window, not its tab. With two agents in one terminal window, you pick the tab yourself.
  • Pressing Esc in Claude Code leaves the agent marked as working until its next turn, because Claude Code sends no event for an interrupt.
Every known issue is in the release notes
Build from source

You need Rust (stable, MSVC), Visual Studio Build Tools with the C++ workload, and Node.js 18+ for the Tauri CLI.

git clone https://github.com/Akash-nath29/AgentFlock.git
cd AgentFlock
npx @tauri-apps/cli@2.12.5 build

The installer lands in src-tauri/target/release/bundle/nsis/.

Put every agent where you can see it.

Download for Windows