by kiyotakali
An open-source AI companion that actually remembers you — runs entirely on your own Mac or server. Desktop pet · long-term memory · proactive companionship · multi-device sync.
Unlocks once the catalog security scan passes (runs nightly).
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
# Add to your Claude Code skills
git clone https://github.com/kiyotakali/MiruGuides for using ai agents skills like Miru.
Miru is 見る — Japanese for to see. Spell it out and it says something else: Memory, I Remember U. She isn't an app you launch when you need something; she lives on your desktop as a Live2D character, quietly follows your day — with your permission — and at midnight writes it into memory.
Three things set her apart from every "AI girlfriend" wrapper:
Sees your day. A screen sensor glances at your screen (default every 60s, skipped when nothing changed, adjustable, or fully off). The screenshot is analyzed and thrown away — what stays is what you were doing, never the image.
Remembers it as facts you can check. Four kinds of long-term memory — projects, people, yourself, topics — plus a daily journal and a commitment list. When you tell a friend "I'll send you the figures tonight," she reads it off the screen and quietly logs the promise.
Comes closer on her own terms. Continuous emotion and a personality of her own (defined in a soul.md). She isn't reactive-only: when she sees you've been stuck for an hour and your mood keeps sinking, she opens the conversation.
Lives across your devices. A Live2D desktop pet on macOS, and the same her on Android — one invitation code, memory synced through your own server.
Miru is free software; you bring your own model API keys (any OpenAI-compatible provider). A recommended setup costs under ¥2/day in tokens.
Prefer to deploy by hand? Grab the linux-amd64 server image (tar.gz) from Releases, docker load, and run it on any Linux box (we test and deploy on Ubuntu 20.04 LTS; newer Ubuntu/Debian works too). Same invitation-code format as the wizard.
macOS / Android app your Mac · or your own Linux server
┌─────────────────────┐ ┌────────────────────────────────────────┐
│ Live2D pet │ │ Flask backend │
│ screen sensor │ ───────> │ · chat agent (reads memory) │
│ thin native shell │ invite │ · AttentionEngine (decides to speak) │
└─────────────────────┘ code │ · memory system (slots + journal) │
│ · sleep agent (organizes at night) │
model API you configured <──┤ · SSE sync across devices │
(any OpenAI-compatible) └────────────────────────────────────────┘
Vision (reads screenshots), Chat (talks to you), Memory (organizes what she keeps). Mix providers freely.If Miru resonates with you, a ⭐ genuinely helps — and lets you follow the road to Windows, iOS, and full open source.
Heartfelt thanks to Jiazhe Wei, Hongzhe Chen, Jingkang Yang, Haofan Wang, and Chenyang Si for their help along the way.
For questions and collaborations, please contact:
Miru is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by kiyotakali. An open-source AI companion that actually remembers you — runs entirely on your own Mac or server. Desktop pet · long-term memory · proactive companionship · multi-device sync. It has 51 GitHub stars.
Miru's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/kiyotakali/Miru" and add it to your Claude Code skills directory (see the Installation section above).
Miru is primarily written in CSS. It is open-source under kiyotakali on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh Miru against similar tools.
No comments yet. Be the first to share your thoughts!