Ambient radio for AI coding agents on macOS.
Agent FM turns Claude Code and Codex sessions into live radio stations on your Mac. Tune into one agent when you need detail, or listen to Global Mix across local and remote workspace 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 local and remote workspace agents instead of jumping between terminal windows.
- Blocker alerts: Hear when an agent is waiting for input, approval, or a decision.
- Remote workspaces: Add remote development environments from Settings using your existing OpenSSH aliases.
- 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. If your agent runs in a remote development environment, add that remote workspace from Settings using an OpenSSH alias.
Requirements:
- macOS 13 Ventura or later on Apple Silicon.
- Claude Code or Codex configured on the same Mac, or on a remote workspace reachable from this Mac over SSH.
- 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 Mac to the provider you configure; Agent FM does not run a proxy server or hosted account system. For remote workspaces, Agent FM uses your existing OpenSSH connection and does not store SSH keys or passwords.
| 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+, pnpm 10+, and Go 1.22+ for the self-contained remote workspace collector.
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.