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
Features
Life on your desktop
Your dog joins in from the first scroll of the day to the last reminder to take a break.
-
A nudge to take a break
Sunny fetches a ball when your Pomodoro ends. When it’s time to walk, Guu brings a leash.
-
A game of hide-and-seek
Your dog can hide at the edge of the screen and peek out. Move closer and it ducks away. Drag it back out when you’re ready.
-
Along for the scroll
Turn on “Scroll along with me” and Mochi runs on a little treadmill while Chikuwa digs.
-
Stretch, bounce, settle
Pull Chikuwa sideways and he springs back. Lift him and he’ll settle wherever you let go.
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.
Winter outfits
-
Shiba · Kinako
A stubborn Shiba who digs in when you pull him sideways.
-
Pug · Guu
A loud snorer who wakes at the mention of food.
-
Corgi · Pan
A big-eared pup who celebrates good news with a wiggle.
-
Dachshund · Chikuwa
Floppy ears and a bark bigger than he is.
-
French Bulldog · Mochi
A little bulldog who grumbles when a task needs your approval.
-
Golden Retriever · Sunny
A gentle companion who likes to bring you a tennis ball.
-
Wuhei · Wangcai
Wangcai showers you with coins, a nod to his name, which means “brings good fortune.”
-
Siberian Husky · Yuki
An ice-blue-eyed husky who celebrates a job well done with a howl.
-
Border Collie · Kiri
An attentive pup who loves to catch a frisbee.
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.