Listenbox

Got a recording?Hand it to your agent

The open-source Listenbox CLI lets Codex, Claude, Cursor, or any shell-capable agent turn it into a podcast episode. Keep it as a draft, or publish it as soon as it is ready. You get the link either way.

listenbox/listenbox-cliQuick start

Listenbox episode

Illustrative workflow

You ask

Publish when ready
Take episode-42.mp4, call it “What the river remembers,” and publish it to The Field Notes when it is ready. Send me the link.

  1. Found your show

    listenbox shows list

  2. Set it to publish

    listenbox episodes create --show field-notes \
  --title "What the river remembers" \
  --file ./episode-42.mp4 \
  --publication publish

  3. Sent back the link

    The file made it to Listenbox. The episode is live.

One CLI. Any agent with a shell

Install it, log in, and use plain commands. Your agent runs the same commands you can, so there is no special magic hiding underneath.

See the code on GitHub

Install and sign in

Runnable as-is · Go 1.27+

go install github.com/listenbox/listenbox-cli/cmd/listenbox@latest

listenbox login

Example: keep it draft (the default)

Replace the sample values

listenbox episodes create \
  --show field-notes \
  --title "What the river remembers" \
  --file ./episode-42.mp4 \
  --publication draft

Give it the fiddly bits

Finding the show, uploading the file, filling in the title—good agent work. Listenbox takes care of the media, then keeps it as a draft or publishes it. Your call.

Your agent can

  • Find your shows and recent episodes
  • Keep an episode as a draft or publish it when ready
  • Add the episode title and description
  • Hand you the Listenbox link

Listenbox takes care of

  • Uploads that can pick up where they left off
  • Making podcast audio from your video
  • Keeping the finished media playable
  • Showing you what is ready without making you guess

Ask like a person. The CLI stays ordinary

Say what you want in plain English. Underneath, the CLI keeps it boring in the best way: regular commands and predictable output.

“Turn sunday-service.mov into this week’s episode, publish it when it is ready, and send me the link.”
“What are the five most recent episodes in field-notes?”
“Upload interview.wav as a draft. I will sort out the notes later.”

It is open source. Have a look

The official Listenbox CLI is written in Go, MIT-licensed, and built on the public API. Use it as-is, tweak it, or just let your agent get on with it.

Open GitHubTry Listenbox