Madowan · A window companion

A pixel dog in your window

A little dog for your desktop that follows your mouse and jumps for joy when Claude Code or Codex finishes. Turn on “Type along with me” and your pup can overheat if you type too fast.

macOS · Windows · No subscription · No data collection

~/desktop

Features

Life on your desktop

Your dog joins in from the first scroll of the day to the last reminder to take a break.

AI agent

A dog to keep you company while AI works

Connect Claude Code, Codex or any tool that can run a command with a little configuration. Madowan receives messages only on 127.0.0.1, right on your computer. No internet connection.

Claude Code

Merge into hooks in ~/.claude/settings.json.

{
  "hooks": {
    "UserPromptSubmit": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "curl -s -m 1 'http://127.0.0.1:47821/event?source=claude&event=thinking' >/dev/null 2>&1 || true"
          }
        ]
      }
    ],
    "Notification": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "curl -s -m 1 'http://127.0.0.1:47821/event?source=claude&event=waiting' >/dev/null 2>&1 || true"
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "curl -s -m 1 'http://127.0.0.1:47821/event?source=claude&event=done' >/dev/null 2>&1 || true"
          }
        ]
      }
    ]
  }
}

Codex

Add at the top level of ~/.codex/config.toml.

notify = ["sh", "-c", "curl -s -m 1 -X POST -H 'Content-Type: application/json' --data-binary \"$1\" http://127.0.0.1:47821/codex >/dev/null 2>&1 || true", "madowan"]

Other tools / scripts

Use anywhere that can run a command. event can be thinking, waiting, done or error.

curl -s 'http://127.0.0.1:47821/event?source=generic&event=done'

Breeds

Nine dogs. Nine personalities.

More than a coat swap: each breed moves its own way. More breeds are on their way.

Madowan.app

Bring your pup home

Free during the beta. The full release is planned as a one-time purchase, with one license for all your computers. No subscription.

Requires macOS 13 or Windows 10 or later. If macOS cannot verify the developer on first launch, right-click in Finder and choose Open.

Questions, answered

Questions, answered

Will it get in the way of clicks?

Clicks pass straight through the window except on the dog and its bubble, so you can keep using the apps underneath.

Does it need Accessibility or keyboard permissions?

By default, Madowan reads mouse position only. “Type along with me” counts key presses, and “Scroll along with me” counts scroll amount and direction. Both are optional, keep their counts on your computer, and require Input Monitoring on macOS.

Are AI agent connections safe?

Madowan listens only on 127.0.0.1 and accepts just four events: thinking, waiting, done and error. Requests from web pages are rejected. It never executes commands.

Does it collect my data?

No accounts, analytics or telemetry. Settings stay on your computer. Read our Privacy notice

What if reminders get annoying?

Turn on Do not disturb in the tray menu, or adjust the intervals and switches in settings. Your dog stays quiet during Pomodoro focus.

What about Linux and more breeds?

Linux support is planned. Tell us which dog you’d like to meet next.