code-akram

Cc Fm Mod — Development skill for Claude Code

Development community

claude.fm in your Claude Code prompt: a live spectrum under the composer, local or over SSH.

How to install Cc Fm Mod

This entry records only its repository, not the path inside it, so there is no exact command to give. Open code-akram/cc-fm-mod and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Cc Fm Mod does

claude.fm in your Claude Code prompt: a live spectrum under the composer, local or over SSH.

Alternatives in Development

  • Cursor Plugin Cc — Use Cursor CLI from Claude Code to delegate coding tasks to Composer 2.5+ and other Cursor models 36 ★
  • Cc Mod Image View — Claude Code mod: thumbnails of pasted images above the prompt instead of bare [Image #n] tags 27 ★
  • Ctx Handoff Mod — Claude Code mod: auto handoff to a fresh conversation when context hits a threshold, keeps the prompt cache wa 25 ★

README

cc-fm

claude.fm in your Claude Code prompt. Audio plays on your machine, and a live spectrum runs in the hint row under the composer, whether Claude Code runs locally or on a server you SSH into.

![cc-fm in Claude Code: live bars under the prompt, /fm status on the rail, and the /fm keys controls lighting up with ctrl+x tab](docs/demo.gif)

An unofficial community project. Not affiliated with or endorsed by Anthropic.

How it works

cc-fm has two parts:

  • cc-fm, a small Go player that runs on the machine with your speakers. A single ffmpeg process plays the stream and feeds an FFT, and the player serves the resulting bars over an owner-only unix socket.
  • The mod, a Claude Code plugin that reads the bars from that socket, draws them under the prompt and adds /fm commands.
 your machine (speakers)                   any machine running Claude Code
┌──────────────────────────┐   ssh -R     ┌────────────────────────────┐
│ cc-fm serve              │◀════════════▶│ ~/.cc-fm/fm.sock           │
│  yt-dlp → ffmpeg ─┬─▶ 🔊 │  commands ▶  │  session A   ♪ ▁▃▇▅▂       │
│                   └─▶ FFT│  ◀ bars      │  session B   ♪ ▁▃▇▅▂       │
└──────────────────────────┘              └────────────────────────────┘

Audio never crosses the network. Only the bar heights do, at under 1 KB/s. Every session, local or remote, connects to the same single player, so running several Claude sessions just works. The wire format is documented in [PROTOCOL.md](PROTOCOL.md).

Requirements

  • Claude Code 2.1.287 or later, the first release with mods
  • On the machine with speakers: macOS or Linux, plus ffmpeg and yt-dlp (Homebrew installs them for you)
  • On the machine running Claude Code: nothing else; the mod talks to the player through Claude Code itself

Setup

1. Install the player on your machine

Pick one:

# Homebrew (macOS, Linux): pulls in ffmpeg and yt-dlp too
brew install code-akram/tap/cc-fm

# Install script: a prebuilt binary to