Show your AI the bug

Luna is a Mac screen recorder for working with AI agents. Press a hotkey, show the problem and say what's wrong. When you stop, your agent gets a small video and a text it can read.

Free and open source · macOS 14 or later · Windows soon

Luna, a black cat with a crescent moon
MCP link https://luna.nimitbhargava.workers.dev/mcp

For ChatGPT, Claude and Claude Code. How to connect

People explained things to people. Now we explain them to agents.

With a teammate, you share your screen, point at the thing and talk it through. That is still the fastest way to explain a bug. Most agents can't watch you do it, though. They read text, and a big screen recording is often more than a chat box will take.

Luna lets you explain it the way you already do, then writes down what happened: where the video is, what you said, and each click with a timestamp. Paste that in and your agent knows what you saw.

Your screen Your voice Your clicks
Copied to your clipboard
~/Movies/ScreenRecordings/Recording_16-04-31.mp4 ### Voice Narration Transcript:
> "When I click Pay, nothing happens."
### User Action Steps:
1. `00:02` Left-click on Button "Pay"
Claude Code Codex Gemini Cursor ChatGPT

What your agent gets

When you stop recording, this text lands on your clipboard and in a file next to the video. It pastes as plain text, not as a file upload, so it works in a terminal and in a browser chat.

  1. 1

    The path comes first

    Agents that can open files, like Claude Code, Codex and Gemini CLI, read the MP4 straight from your disk.

  2. 2

    The page you were on

    If you recorded a browser, Luna notes the URL. Works with Chrome, Safari, Arc, Brave and Edge.

  3. 3

    What you said

    Talk while you record. Luna transcribes it, so the agent hears the bug in your words.

  4. 4

    Keyframes

    Up to six stills from the moments the screen changed, for models that read images but not video.

  5. 5

    Every click

    Which app, which button, where on screen, and when. Keystrokes are never logged.

Recording_2026-10-12_16-04-31.prompt.md
/Users/you/Movies/ScreenRecordings/Recording_2026-10-12_16-04-31.mp41

### Screen Recording Context & Interaction Log
- **Video File**: `/Users/you/Movies/ScreenRecordings/Recording_2026-10-12_16-04-31.mp4`
- **Target Webpage**: `http://localhost:3000/checkout`2
- **Environment**: macOS (Version 26.3) | 1512×982 @ 2x

### Voice Narration Transcript:3
> "When I click Pay, nothing happens. No spinner, no error."

### Keyframe Snapshots (Apple Vision Saliency):4
1. `/Users/you/Movies/ScreenRecordings/Recording_2026-10-12_16-04-31.keyframes/step1_00-00.png`
2. `/Users/you/Movies/ScreenRecordings/Recording_2026-10-12_16-04-31.keyframes/step2_00-02.png`

### User Action Steps:5
1. `00:00` - Switched to Google Chrome ("Checkout")
2. `00:02` - Google Chrome: Left-click on Button "Pay $24.00" at (812, 540)
3. `00:05` - Google Chrome: Left-click on Button "Pay $24.00" at (812, 541)

Start, stop, paste

Luna lives in your menu bar. Two hotkeys cover almost everything.

Step 1

Pick what to record

Press ⌘⌥1 and drag over the part that matters. Click instead of dragging to record the whole screen.

Step 2

Show it and say it

Click through the bug and talk the way you would to a teammate. The floating bar has pause, stop and your mic.

Step 3

Stop and paste

Press ⌘⌥S. The path and context are on your clipboard. Paste into your agent with ⌘V.

Every shortcut

⌘⌥1Record an area you drag
⌘⌥2Choose a window or screen
⌘⌥3Record the full screen
⌘⌥SStop and copy
⌘⌥ROpen your recordings

Also in the box

  • Small MP4s

    H.264 with the index up front, so Gemini, ChatGPT and Claude uploads take it without a format error.

  • Click highlights

    Every click shows a ring in the video, so nobody has to guess where you clicked.

  • A library of clips

    Play any recording again, then Copy for LLMs, Copy MP4 or Copy GIF. Select several to send them together.

  • Mic and system audio

    Pick a microphone, or record what your Mac is playing. Both can go in one clip.

  • Cleans up after itself

    Bug clips are throwaway. Luna can delete them after the number of days you choose, or keep them all.

  • Your files, your Mac

    No account. Recordings are plain files in ~/Movies/ScreenRecordings.

Use it with the AI you already use

Pasting works everywhere. For tighter loops, Luna also plugs in directly.

Connect any AI with MCP

Add this URL to ChatGPT or Claude and enter the 6-character code from Luna > Settings > ChatGPT & Claude. Your AI can then read the recordings you choose to upload.

https://luna.nimitbhargava.workers.dev/mcp
  • ChatGPTSettings > Apps > Advanced settings > Developer Mode, then add the URL as an app.
  • ClaudeSettings > Connectors > Add custom connector, then paste the URL.
  • Claude Codeclaude mcp add --transport http luna https://luna.nimitbhargava.workers.dev/mcp

Talk it through in ChatGPT

ChatGPT can't read video. Upload a recording through Luna's ChatGPT plugin and discuss it with AI, even from your phone.

Open source, MIT licensed

The code is on GitHub. The best way to ask for something is an issue in plain words. If it fits, it gets built.

Mac

macOS 14 Sonoma or later

Available now

Windows

Being built in the open. Follow issue #1

Coming soon
Luna, a black cat with a crescent moon

Record your next bug with Luna

Scan to try Luna

Free and open source for Mac

QR code that opens luna.nimit.dev
luna.nimit.dev
Download QR