πŸ¦† now wired into Claude Code

Rubber Ducky

The old rubber duck that used to just sit there while you rambled through your bugs now actually replies. Can't yap out loud in public? Just type it β€” the duck still checks your files, draws the diagram, and talks back.

Installed it? Run rubber-duck . in your project's terminal to open the duck for that project.

macOS still hasn't met the duck yet β€” see the to-do list.

Duck points

Why this duck earns its place on your desk

Every point below is a Duck Pointβ„’ β€” small, yellow, and non-negotiable.

You chat, it talks

A floating, always-on-top desktop buddy you type your bug at β€” because you can't always yap out loud in public β€” and it responds like a real rubber-duck session should have all along.

Reads your code

Read-only access to your project directory, so while you're rambling, it can quietly check the file you're actually talking about.

Remembers the session

Every project gets its own .duck.json. Close the app, come back tomorrow, and pick the conversation back up exactly where you left it.

Draws the whiteboard

Can pull up live Mermaid diagrams and syntax-highlighted snippets in its own viewer window mid-conversation β€” like it's actually pointing at something.

Talks back out loud

You type, the duck talks β€” replies are read aloud instead of just dumped as text, closer to a real conversation than a chat window.

One hotkey away

Ctrl + Alt + Shift + Z summons or hides the duck instantly, from anywhere on your screen.

Stays out of the way

Frameless, transparent, tiny, and anchored neatly to a corner of your screen β€” until you need it, then it opens right up.

Runs on Claude Code

Built directly on the Claude Code CLI you already trust with your codebase β€” no extra API keys, no separate account to juggle.

Still in the pond

What's left to build

The duck is a work in progress. Here's what's still floating on the to-do list β€” open a PR if one of these has your name on it.

  • Mac executable

    Package Rubber Ducky as a proper signed .dmg / .app so macOS folks can finally join in.

  • Free AI options

    Support free and local models, so you don't need a paid Claude plan just to chat with a duck.

  • Other AI tools

    Hook up support for Codex, and other coding agents/CLIs beyond Claude Code.

  • Better duck animations

    More expressive idle, listening, and talking animations β€” the duck deserves more than a bob.

  • A quack that doesn't suck

    Replace the placeholder quack with something that sounds good on the fiftieth debugging session of the day.

Say hi

Talk to the human behind the duck

Ideas, bug reports, or just want to say the duck helped you ship something β€” find me here.