Agent FM

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

Demo

What it does

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

Global Mix

Individual Station

Quick start

Download the signed macOS build from the latest release:

Download Agent FM for macOS

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.

Bring your own keys

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.

Development

To run Agent FM from source:

git clone https://github.com/agentfm-ai/agent-fm.git
cd agent-fm
corepack enable
pnpm install
pnpm start

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

Project links

• Privacy
• Contributing
• Security
• Code of Conduct
• Changelog
• License

License

Apache License 2.0. See LICENSE for details.