whatisgithub

What is agent-fm?

agentfm-ai/agent-fm — explained in plain English

Analysis updated 2026-05-18

21TypeScriptAudience · developerComplexity · 2/5LicenseSetup · easy

In one sentence

A macOS app that narrates your active Claude Code and Codex terminal sessions as audio, like a radio station for AI agents.

Mindmap

mindmap
  root((Agent FM))
    What it does
      Narrates agent sessions
      Audio station per agent
      Global Mix summary
    Tech stack
      Electron
      TypeScript
      pnpm and Vite
    Use cases
      Track parallel agents
      Blocker alerts
      Ambient status updates
    Audience
      Developers using AI agents
    Setup
      Download signed DMG
      Bring your own API key

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Keep track of multiple AI coding agents running in parallel without checking each terminal.

USE CASE 2

Get an audio alert when a Claude Code or Codex session is blocked and needs your input.

USE CASE 3

Listen to a Global Mix summary of all your active agents while doing other work.

What is it built with?

TypeScriptElectronpnpmVite

How does it compare?

agentfm-ai/agent-fmame-x/auto-pptdj931567261/app-test-control
Stars212121
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasymoderatehard
Complexity2/52/54/5
Audiencedevelopervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires an Apple Silicon Mac on macOS 13+ and your own Gemini or OpenAI API key.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

Agent FM is a macOS desktop app that turns your AI coding sessions into something you can listen to like a radio station. If you run AI coding agents, such as Claude Code or OpenAI Codex, in your terminal while doing other work, Agent FM monitors each active agent session and narrates what is happening as audio, so you can hear progress updates, blockers, and alerts without watching a terminal window. You can tune into a single agent's station for detailed play by play, or switch to Global Mix to hear a summary across all running agents at once. The practical problem it solves is attention management. When you have several AI agents working in parallel, jumping between terminal windows to check their status is disruptive. Agent FM lets you stay aware of what each agent is doing, especially when an agent gets stuck and needs your input or approval, without constantly checking. The app runs entirely on your Mac, requiring Apple Silicon and macOS 13 or later. It reads your Claude Code or Codex session logs locally. For the narration and speech, it uses either Google's Gemini or OpenAI's API, you bring your own API key, which is stored using macOS's secure storage system. The app does not route your data through any Agent FM server, requests go directly from your machine to the AI provider you choose. The tech stack is TypeScript, built as an Electron app, a framework for building desktop applications with web technologies, bundled with pnpm and Vite. It is available as a pre built signed macOS DMG download.

Copy-paste prompts

Prompt 1
Explain how Agent FM narrates a Claude Code session as audio without a hosted server.
Prompt 2
Walk me through setting up Agent FM with my own Gemini or OpenAI API key.
Prompt 3
How does Agent FM read local Claude Code and Codex session logs on macOS?
Prompt 4
Build Agent FM from source using pnpm and explain the Electron project structure.

Frequently asked questions

What is agent-fm?

A macOS app that narrates your active Claude Code and Codex terminal sessions as audio, like a radio station for AI agents.

What language is agent-fm written in?

Mainly TypeScript. The stack also includes TypeScript, Electron, pnpm.

What license does agent-fm use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is agent-fm to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is agent-fm for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.