These alien dogs want to live in your computer. Would you let them in?

Planet Maiko is a free local dev tool made by 1 dev, for other devs, to make your working day a bit more fun!

All the required agent orchestration work. Automatically kicks off agents, lets them yell at each other (with Maiko as the mediator), agent task lifecycles, context sharing... but also some more interesting features as well such as conflict detection, (experimental) fine-tuning, self-curated shared memory and insights etc...

Internal knowledge and specific gotchas get captured automatically, no manual write-ups. When an agent works on something, it only sees the handful of rules that matter for that change. You can keep a pool of hundreds of very specific nits without drowning every prompt.

When one gets something wrong it writes down what it learned, and the whole pack reads it. Future agents inherit those notes in their preamble, so a gotcha gets discovered once.

Plug in any data you need by building 1 python class. Internal tools, big names, whatever shiny new GSD task manager you are trying this week.

Current integrations:

• PagerDuty
• Linear
• Calendar
• GitHub

• Runs locally on your laptop. Nothing leaves your machine.
• No telemetry, no hosted account, no cloud.

Open source, free forever, no paid tiers or subscriptions.

Full feature list

• macOS (or Linux/Windows for development)
• Python 3.10+
• Node.js 18+
• gh CLI
• Claude Code (the agent runtime), installed and on your PATH

git clone https://github.com/bkawa-bot/planet-maiko.git
cd planet-maiko

python3 -m venv .venv && source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -e .
cd frontend && npm install && cd ..

gh auth login    # GitHub: repo discovery + worktrees

SSL errors with Linear or other integrations? pip install --upgrade certifi, then open /Applications/Python\ 3.12/Install\ Certificates.command.

One command:

That starts the backend, starts the frontend, and opens http://localhost:5173 for you. Ctrl+C stops both. First run creates its own database and config, then shows a setup wizard.

Prefer two terminals? maiko serve (backend, port 8420) and, in another, cd frontend && npm run dev (frontend, port 5173).

There's an experimental Tauri desktop shell (make app), but it's currently buggy. The terminal launch above is the supported path.

Full guide (mental model, architecture, plugin system, extending, CLI reference): see docs/GUIDE.md.

Planet Maiko is named lovingly after my real dog Maiko.

I made this as one person in my free time for fun, sorry if it is buggy or bad.

Created by Brigitte Kawaguchi