Ambient radio for AI coding agents on macOS.
Agent FM turns every Claude Code and Codex session into a live radio station. Tune into one agent when you need detail, or listen to Global Mix across all active agents. It surfaces progress, blockers, decisions, errors, and attention requests in real time so you do not have to read every terminal transcript.
Download for macOS · Watch demo
- Agent stations: Each Claude Code or Codex session becomes a station you can tune into.
- Global Mix: Listen across all active agents instead of jumping between terminal windows.
- Blocker alerts: Hear when an agent is waiting for input, approval, or a decision.
- Bring your own key: Use Gemini or OpenAI directly; Agent FM runs locally and does not proxy requests through a hosted service.
Download the signed macOS build from the latest release:
Open the DMG, move Agent FM to Applications, then launch the app. During onboarding, add a Gemini or OpenAI API key and start or continue a Claude Code or Codex session on the same Mac.
Requirements:
- macOS 13 Ventura or later on Apple Silicon.
- Claude Code or Codex configured on the same Mac.
- A Gemini or OpenAI API key for narration.
Agent FM is BYOK. You paste your provider key into the app during onboarding, and it is stored with macOS secure storage. The app sends session context directly from your machine to the provider you configure; Agent FM does not run a proxy server or hosted account system.
| Provider | Role | Used for |
|---|---|---|
| Gemini | Recommended primary provider | Narration, speech, companion responses |
| OpenAI | Alternative primary provider | Narration, speech, companion responses |
See PRIVACY.md for the full data-flow details.
To run Agent FM from source:
git clone https://github.com/agentfm-ai/agent-fm.git
cd agent-fm
corepack enable
pnpm install
pnpm startSource builds require Node.js 20+ and pnpm 10+.
Common commands:
| Command | Purpose |
|---|---|
pnpm start |
Build and launch the Electron app |
pnpm dev |
Watch main, preload, and renderer bundles |
pnpm typecheck:main |
Strict TypeScript check |
pnpm lint |
Biome lint |
pnpm test |
Unit test suite |
pnpm make |
Build a macOS DMG |
For contribution guidelines, see CONTRIBUTING.md.
Apache License 2.0. See LICENSE for details.


