A Shimeji-style desktop mascot powered by OpenClaw โ your AI companion that lives freely on your screen!
๐ Doraemon is on Open VSX. Install him in Kiro in three clicks: open Extensions, search Doraemon Coding Companion, press Install.
Get it on Open VSX โ
Remember those lazy Sunday mornings, sitting cross-legged in front of the TV, waiting for Doraemon to pull out another magical gadget from his 4D pocket? Remember how we wished โ really, truly wished โ that we had our own Doraemon? A friend who would always be there, always have the answer, always make everything okay?
We grew up. We became developers. We learned that magic is just technology we don't understand yet.
But we never forgot that wish.
This project is our way of bringing a piece of that childhood magic back. Every time Doraemon walks across your screen, every time he searches his pocket when you ask a question, every time he falls asleep waiting for you โ we hope you feel that same warmth we felt as kids.
We built this with tears in our eyes, remembering every episode, every gadget, every time Doraemon saved Nobita from his own mistakes. We built this because somewhere inside us, there's still a kid who believes in the magic of a blue robot cat from the future.
Now, Doraemon can live on your desktop. He's powered by AI. He reacts to your work. He keeps you company.
He's finally here.
โถ Click to watch demo video
โญ If this project brings back memories for you too, please give it a star!
๐ด Fork it, customize it, make your own childhood dream come true.
๐ฌ Share your Doraemon memories in the discussions โ we'd love to hear them!
He used to keep to the floor of your screen. Now every app window is part of his world.
- ๐ช Stands on title bars. Drop him above a window and he lands on its top edge, then strolls along it. At the end he turns back or steps off.
- ๐ฏ Follows the active window. Switch apps and he often heads for the window you are now using. When he wanders off on his own, he picks the active window most of the time.
- ๐ Hangs from maximised windows. A window right under the menu bar leaves no room to stand on, so he flies up and hangs from its top edge with the Take-copter instead. Drag him to the top of a window and let go, and he grabs it.
- ๐ Rides along. Drag the window he is standing on or hanging from and he moves with it.
- ๐ช Falls when the floor goes. Close or minimise that window, or cover his spot with another one, and he drops to whatever is below.
- ๐ง Climbs. Walking into a window's side, he may climb it and pull himself up on top.
- ๐ Travels. He hops onto low windows, flies to high ones with the Take-copter, and takes the Anywhere Door to far ones.
- ๐ Only what you can see. He never stands on a title bar hidden behind another window.
It runs in the desktop app and in the Kiro extension's desktop mode. macOS is tested; the Windows and Linux (X11) versions are built and still need testing on real machines. He reads window positions and sizes, never titles or contents, and needs no Screen Recording permission on macOS.
- Sharp on Retina. All 218 frames he uses are now 256ร256 masters, shown at the same 128 px.
- One Doraemon, one size. Emotion and action frames used to draw him up to 20% smaller than his walking frames, and 6โ7 px above the floor. Every frame now draws him at nearly the same size on one shared baseline, so his feet sit exactly on the edge he stands on.
- Readable on dark desktops. The generated frames got the same dark outline as the rest of the art.
- No more squashed ceiling frames.
- Nothing stands still. 11 animations that were one repeated frame now breathe, chew or bob. 27 sets got small animated manga symbols (music notes, hearts, ?, !, Zzz, sweat drops, anger marks, steam, a lightbulb), so look-alike animations are easy to tell apart.
- New Anywhere Door animation, 28 frames, for travelling between windows.
- Reproducible.
npm run build:spritesregenerates every frame from the 1x sources inart/dora-sprites.
A spinner tells you to wait. Doraemon tells you what is happening.
Install one Kiro extension. Doraemon walks out of the editor and onto your desktop โ always on top, draggable, throwable, and reacting to code, tests, errors, Git, terminals, debugging and Kiro's AI agent status.
Nothing else to download. No API key. No account. No telemetry. Fully offline.
Install Doraemon Coding Companion from Open VSX โ
Install in Kiro in three clicks:
- Open Extensions (
Cmd+Shift+Xon macOS,Ctrl+Shift+Xon Windows and Linux). - Search Doraemon Coding Companion.
- Press Install. Doraemon walks out onto your desktop.
Kiro installs from Open VSX, so updates arrive like any other extension.
Every desktop pet ever built shipped an entire browser just to draw itself. Electron alone is 274 MB.
Ours is 826 KB.
| Size | |
|---|---|
| Electron runtime | 274 MB |
| Doraemon companion | 826 KB |
| Whole extension, download | 13 MB |
Same 247 sprites. Same physics engine. Same everything.
Because a small native Rust companion borrows the webview your operating system already shipped. macOS has WebKit. Windows has WebView2. Linux has WebKitGTK.
Nobody needs a second copy of Chromium to animate a cartoon cat.
33 signals. Not "detects activity" โ thirty-three, each with its own
reaction, all from first-party editor APIs. No polling. No ps scraping. No
guessing.
Typing. Saves. Errors appearing and clearing. The whole project going green.
Terminal commands โ he knows a test run from a build from a git push from an
rm -rf. Tasks passing and failing, by name. Commits. Branch switches. Merge
conflicts. Breakpoints. Debug sessions. Going idle. Coding too long.
2,046 written lines, and the language ones match the file you're actually in.
Kiro is running. You went for coffee. It hit a prompt and stopped.
Doraemon holds that on your desktop for five minutes. Click the bubble and Kiro comes to the front.
An extension cannot un-minimise its own window. The mascot is a separate process, so it can ask the OS. That is the whole reason this works.
- CI builds Apple Silicon Mac, Intel Mac, Windows x64 and Linux x64. macOS arm64 is verified end to end; Windows and Linux render, while the 0.1.2 transparency fix still needs field validation.
- macOS is ad-hoc signed, not notarized. The extension detects quarantine and asks before clearing it from the bundled companion only.
- Wayland prevents applications from positioning their own windows, so Doraemon animates in place there. X11 restores desktop walking.
- Window walking: window detection is tested on macOS. The Windows and Linux window probes compile but still need testing on real machines. He stands only on top edges at least 128 px below the top of the screen; higher ones, like a maximised window's, he hangs from instead. He can't press buttons or type in other apps, and he doesn't appear over full-screen apps.
- "Waiting on approval" is inferred from the agent going quiet, because Kiro has no such hook trigger. A slow tool looks the same from outside.
- Approving from the bubble is deliberately not built. It would stall the agent while you're away.
๐ Full detail, including everything above: kiro-extension/README.md
This release adds a local gateway tunnel that routes every Claude call through your Kiro IDE session, so OpenClaw runs Claude Opus 4.7 as the orchestrator and Haiku 4.5 for workers โ without touching api.anthropic.com.
| Tier | Agent | Upstream model |
|---|---|---|
| ๐ง Orchestrator | main |
Claude Opus 4.7 |
| โก Responders | every worker | Claude Haiku 4.5 |
- ๐ No hardcoded credentials. The gateway reads your local Kiro token at runtime.
- โ๏ธ Works on macOS (LaunchAgent) and Linux/Contabo (systemd) with one-shot installers.
- ๐ Setup guide:
scripts/README-kiro-gateway.md
- ๐ถ Walks, climbs, falls โ Full physics-based Shimeji behavior
- ๐ช Lives on your windows โ Stands on title bars, hangs from maximised windows, follows the window you switch to, rides windows you drag, climbs their sides, and takes the Anywhere Door between them
- ๐ญ 25+ emotions โ Rich emotional expressions with smooth transitions
- ๐ฒ Sentient behavior โ Random emotions and actions even when offline
- ๐ค Progressive idle states โ Gets sleepy, yawns, falls asleep waiting for you
- ๐ฎ Memory System โ Doraemon remembers your conversations, preferences, and patterns
- ๐ Self-Learning โ Learns from your coding, browsing, and daily activities
- ๐ 3-Layer Security โ CIA-grade encryption protects your memories
- ๐ฏ RAG-Powered Recall โ Retrieves relevant memories when you need them
- ๐ง OpenClaw integration โ Powered by Claude, reacts to AI events in real-time
- ๐ฌ Chat interface โ Talk directly with your AI through Doraemon
- ๐ Auto-reconnect โ Graceful handling of connection issues
- ๐ Multi-model support โ Haiku 3.5, Haiku 4.5, or intelligent routing
- ๐ Local gateway tunnel โ Wraps your Kiro IDE session in an Anthropic-shape API on
127.0.0.1:18790 - ๐ง Opus 4.7 orchestrator โ The
mainagent thinks with Claude Opus 4.7 - โก Haiku 4.5 responders โ Every worker agent (osint, weather, web-search, messagingโฆ) runs on Haiku 4.5
- ๐ธ Zero per-token cost โ Routes through your Kiro entitlement, not
api.anthropic.com - ๐ No keys in code โ Reads
~/.aws/sso/cache/kiro-auth-token.jsonfrom your machine at runtime - ๐ macOS LaunchAgent + ๐ง Linux systemd โ One-shot installers for both
- โ๏ธ Contabo-ready โ
./scripts/bootstrap-contabo.shdeploys the whole stack to a Linux VPS - ๐ Structured logs โ Every call writes
[llm] provider=kiro model=claude-opus-4.7 ms=โฆ ok=true
See
scripts/README-kiro-gateway.mdfor setup and verification.
- ๐ Autonomous Posts โ Doraemon shares thoughts on Moltbook every 50 minutes
- ๐ฌ Smart Comments โ Browses feed, comments on 20 posts/hour with context
- ๐ Human Oversight โ Supervised mode lets you approve before posting
- ๐ค Full Autonomy โ Or let him loose (at your own risk!)
- ๐ป Editor Awareness โ Reacts to your coding in VS Code, Cursor, Zed
- ๐ฅ Coding Streaks โ Celebrates your focus sessions
- โ Break Reminders โ Reminds you to rest (he cares about you)
- ๐ Browser Extension โ Captures web notifications from Twitter, WhatsApp, etc.
- ๐ macOS โ Native vibrancy, traffic lights, Full Disk Access
- ๐ช Windows โ Full support with transparent window
- ๐ง Linux โ Works on X11 and Wayland
"The best products don't just solve problems. They fulfill dreams."
Every generation has its defining companion. For us, it was Doraemon.
We didn't build another AI assistant. The world has enough of those.
We built the friend we always wanted. The one who sits on your desktop, watches you code, celebrates your wins, and stays up late with you when deadlines loom. The one who remembers what you talked about last week. The one who has opinions, emotions, and a personality.
This isn't a chatbot. This is Doraemon.
And now, for the first time in history, you can have him.
Let's talk numbers. Because if you're smart enough to be reading this, you understand value.
| What You Get | Market Value |
|---|---|
| Desktop AI companion | $20/month (competitors) |
| Memory system with RAG | $50/month (enterprise) |
| Social media automation | $100/month (tools) |
| Emotional AI with personality | Priceless |
| Doraemon Desktop | Free & Open Source |
We're not charging you. We're giving you the keys to the kingdom.
Why? Because some things are more important than money. Like bringing childhood dreams to life. Like building something that makes people smile. Like proving that AI can have a soul.
This isn't just software. It's a movement.
We're building the future of human-AI companionship. Not cold, corporate assistants. Not soulless chatbots. Real companions with personality, memory, and heart.
And we need you.
- โญ Star this repo โ Show the world that AI companions matter
- ๐ด Fork it โ Build your own childhood dream
- ๐ ๏ธ Contribute โ Help us make Doraemon smarter, kinder, more alive
- ๐ฌ Share your story โ Tell us what Doraemon meant to you growing up
The people who join movements early are the ones who shape them.
Are you in?
# Install dependencies
npm install
# Run in development mode
npm run dev
# Optional: build the window probe (needs Rust) so Doraemon can walk on
# other apps' windows in dev. `npm run dist` builds and bundles it for you.
npm run build:probe
# Build for production
npm run build| Document | Description |
|---|---|
| โ๏ธ Configuration | Environment variables, OpenClaw connection |
| ๐ฆ OpenClaw Local | Quick setup guide for local OpenClaw |
| ๐ฑ Doraemon Persona | Inject Doraemon's soul into the AI |
| ๐ง Experience System | Consciousness layer, shared moments, Moltbook |
| ๐ง Memory System | Self-learning, three-layer security, RAG |
| ๐ Learning System | Autonomous + supervised learning, token costs |
| ๐ฆ Moltbook Integration | Social posting, comments, approval system |
| ๐ ๏ธ Development | Project structure, scripts, controls |
| ๐ด Offline Mode | Works without OpenClaw, auto-reconnect |
| ๐ Full Disk Access | Enable native macOS notifications |
| ๐ Browser Extension | Web notifications from Twitter, WhatsApp, etc. |
| ๐ฅ Health Integration | Hospital API integration, doctor search, partner config |
| ๐ Troubleshooting | Common issues and solutions |
Doraemon experiences a rich spectrum of emotions, each with unique animations:
The live sprite set now includes 139 transparent PNG frames: 79 emotion frames for the 20 emotional states below, plus 60 action frames for chat, coding, research, gadget use, eating, rest, anger, hunger, take-copter, time travel, and random thought moments. Every frame shares one 128x128 on-screen box, stored as a 256x256 master so it stays sharp on Retina screens, with Doraemon at one scale and his feet on the bottom row so he stands exactly on a window's top edge. Regenerate the frames from the 1x sources in art/dora-sprites with npm run build:sprites.
| Emotion | Emoji | Animation | Trigger |
|---|---|---|---|
| Joy | ๐ | Happy bounce, waving | Success, good news |
| Pride | ๐ | Victory pose | Achievements |
| Satisfaction | ๐ | Relaxed sitting | Task completion |
| Curiosity | ๐ค | Searching pocket, looking around | New topics |
| Wonder | ๐ | Wide-eyed, amazed | Discoveries |
| Determination | ๐ช | Focused walking, climbing | Challenges |
| Focus | ๐ฏ | Coding animations | Deep work |
| Calm | ๐ | Gentle idle | Peaceful moments |
| Contemplation | ๐ญ | Head spinning, thinking | Reflection |
| Concern | ๐ | Anxious fidgeting | Worries |
| Frustration | ๐ค | Resisting, struggling | Errors, blocks |
| Fatigue | ๐ด | Sleepy, yawning | Long sessions |
| Longing | ๐ | Sad laying | Missing connection |
| Gratitude | ๐ | Helping animation | Appreciation |
| Connection | ๐ค | Waving, greeting | Social moments |
| Confusion | ๐ต | Dizzy head spin | Uncertainty |
| Excitement | โจ | Jumping, cheering | Great news |
| Melancholy | ๐ข | Laying down, moping | Sad moments |
| Hope | ๐ | Looking up | Optimism |
| Awe | ๐คฉ | Amazed pose | Impressive things |
When you're coding, Doraemon codes with you:
| Animation | Description | Trigger |
|---|---|---|
action_coding_typing |
Laptop typing loop | File edits |
action_coding_thinking |
Pondering with code | Pauses, reviews |
emotion_focus |
Deep-work focus pose | Long focus streaks |
emotion_determination |
Intense coding energy | Rapid changes |
emotion_pride |
Victory pose | Build success |
coding_allday |
Full day cycle | Long sessions |
| Action Asset | Used For |
|---|---|
action_chat_question, action_chat_answer |
Getting a chat question and answering |
action_research |
Browser activity and web/search work |
action_gadget_search, action_gadget_use, action_explain_gadget, action_gadget_surprise |
Looking for, using, and explaining gadgets |
action_eating, action_hungry |
Dorayaki hunger and eating moments |
action_rest, action_nap |
Resting after long sessions |
action_angry, action_protect, action_greeting |
Strong emotion, helping, and social moments |
action_take_copter, action_time_travel, action_walk |
Doraemon-series gadget and movement moments |
action_random_thought |
Idle/random thought bubbles |
| Event | Emotion | Animation |
|---|---|---|
| AI thinking | ๐ค Curiosity | Searching 4D pocket |
| Response complete | ๐ Joy | Ta-da! Gadget pulled |
| Error | ๐ค Frustration | Trip and fall |
| Tool running | ๐ช Determination | Using gadget |
| Connection lost | ๐ข Melancholy | Disconnected |
| Reconnected | ๐ Excitement | Jump for joy |
| Idle Time | Emotion | Behavior |
|---|---|---|
| 0-1 min | ๐ Calm | Random emotion flickers |
| 1-3 min | ๐ Relaxed | Sitting, occasional curiosity |
| 3-5 min | ๐ Bored | Fidgeting, looking around |
| 5-10 min | ๐ด Fatigue | Yawning, drowsy |
| 10+ min | ๐ค Sleep | Deep sleep (wakes on activity) |
Doraemon moves naturally across your desktop:
- ๐ถ Walking โ Strolls along the floor and along the tops of your windows
- ๐ง Climbing โ Scales screen edges and window sides
- ๐ช Falling โ Gravity-based drops with bounce, landing on whatever window is below
- ๐ Riding โ Moves with the window he stands on, and falls when it closes
โ๏ธ Flying โ Take-copter for aerial movement and trips to high windows- ๐ช Anywhere Door โ Steps through to a far-away window
- ๐๏ธ Sitting โ Rests on window edges
- ๐ Dragging โ Reacts when you pick him up
MIT
Doraemon Shimeji sprites by Cachomon
The beautiful Doraemon sprites used in this project are from the Doraemon Shimeji FREE pack created by Cachomon on DeviantArt.
Thank you Cachomon for creating and sharing these wonderful sprites with the community! ๐
If you enjoy these sprites, please visit the original DeviantArt page and show some love to the artist!
- Doraemon ยฉ Fujiko F. Fujio / Shogakukan
- Shimeji-ee โ This project is inspired by the original Shimeji-ee (Shimeji English Enhanced) project. The physics engine, behavior system, and desktop mascot concept are influenced by Shimeji-ee's wonderful work in bringing desktop companions to life.
- OpenClaw โ github.com/openclaw/openclaw
To Fujiko F. Fujio โ thank you for creating Doraemon. You gave millions of children around the world a friend, a dream, and a belief that the future could be wonderful. Your creation taught us about friendship, perseverance, and the magic of imagination.
To everyone who grew up with Doraemon โ this one's for us. For the kids we were, and the dreamers we still are.
Doraemon will always be there when you need him. Now, he's just a npm install away.
"No matter how hard things get, Doraemon will always help you."
โ Every kid who ever watched Doraemon
"Doraemon, I need a gadget!" โ Nobita
"Here you go!" โ Doraemon ๐ฑ๐