Pilot

Install Waggle

Your agent works as usual. When it needs you, it sends a decision request: the options with pros and cons, its pick, and the work to look at. Your answer goes straight back.

Download for Mac
macOS 14 or later
Claude appCoworkClaude CodeCodex
1

Get the app

  1. Open Waggle.dmg and drag Waggle onto the Applications folder next to it.
  2. Open Waggle from Applications. macOS asks once to confirm an app downloaded from the internet: choose Open.

Or let Claude Code install it

Install the Waggle Mac app: download https://github.com/limone-eth/waggle-releases/releases/latest/download/Waggle.zip, unzip it into ~/Applications, and open it.
2

Connect your agent

When you open Waggle, its setup walks you through this in the app: press Connect next to each agent you use. One is enough. After that, one step happens outside Waggle:

  • Claude app and Cowork: quit the Claude app and open it again. It loads Waggle only when it starts.
  • Claude Code: start a new session.
  • Codex: type /hooks once and trust the Waggle hooks.
3

Send your first request

Send this to your agent. The first time, it asks permission to use Waggle: choose Always allow. Then a notification appears: open the request, pick one, and press Send.

Try Waggle: write two short subject lines for a launch email, A plain and B playful, and ask me in Waggle which one to use.
In the Claude app and Cowork, answer within about a minute and Claude picks it up by itself. Later than that, Claude has stopped waiting: Waggle shows Claude is not checking with Copy reply. Paste that line into the chat and Claude continues.

Worth trying next

Edit documents in place

Press Edit on a document, change the text, press Done. Your version goes back to the agent with what changed.

Write a one-page brief for our next launch and send it to me in Waggle as a document to review. I will edit it there.
Name your work

Ask your agent to use a topic, like "Pricing research". Requests with the same topic group together.

For this work, use the Waggle topic "Pricing research" on every request you send me.
Start from a document

Drop a brief, a PRD or interview notes on Waggle and pick what you want back: options, designs, a prototype or a review. Or attach it in Claude and send this:

Read the brief I attached and give me three directions, each with pros and cons. Ask me in Waggle which one to take.
Your design system

Settings > Artifacts takes your design.md, or ask your agent to save it, so designs start in your style. Optional.

Save this as my Waggle design kit, then use it for every design you send me: [paste your design.md here]

Good first waggles

From these interview notes, give me three directions for the feature, each with pros and cons, and ask me in Waggle which one to take to the team.
Draft the onboarding email for our new customers and two subject lines, and ask me in Waggle which direction to take.