introduction.mdx

title	Makakoo OS: shared AI brain for every CLI
description	Makakoo OS gives every AI CLI on your machine a persistent, shared brain. Local-first, pure Rust, MIT licensed. Install once — Claude, Gemini, Codex all remember.

Makakoo OS is an autonomous cognitive extension that installs once and gives every AI CLI on your machine — Claude Code, Gemini CLI, Codex, OpenCode, Vibe, Cursor, Qwen, Kimi, and pi — the same persistent memory, the same tools, and the same context. No more goldfish sessions. No more repeating yourself.

Get Makakoo running in under 5 minutes Detailed per-OS install guide with troubleshooting Understand the Brain, infect, SANCHO, and the capability sandbox Every `makakoo` subcommand, flag, and default value

What Makakoo OS does

Every AI CLI session starts from zero. Claude doesn't know what you told Gemini yesterday. Codex doesn't know the architectural decision you made in OpenCode last week. Makakoo fixes this.

Logseq-backed markdown journals and pages — readable by any AI CLI, writable through any infected session One command writes a shared bootstrap block into every AI CLI's config. 9 CLIs + 4 IDE assistants supported FTS5 full-text + vector similarity + LLM synthesis. Ask questions in plain language Proactive tasks run while you sleep: daily briefings, memory consolidation, plugin tasks 38 sandboxed plugins shipped. Capability-gated, manifest-declared, Python or Rust 5 curated bundles — minimal, core, sebastian, creator, trader — for different workflows

Get started in 60 seconds

Run the one-liner for your OS — the installer downloads pre-built binaries and hands off to `makakoo install` automatically.

```bash macOS / Linux
curl -fsSL https://makakoo.com/install.sh | sh
```

```powershell Windows
iwr -UseBasicParsing https://makakoo.com/install.ps1 | iex
```

`makakoo install` hands off to the interactive wizard automatically. It configures your persona, Brain location, AI CLI hosts, and LLM provider. Press Enter to accept defaults — you can change everything later. ```bash makakoo --version makakoo daemon status makakoo query "hello" ```

You should see the version, the daemon running, and a Brain query response.

```bash claude # or gemini, codex, opencode, vibe — whichever you have ```

Every session now opens with a Makakoo bootstrap block. The AI knows your Brain location and has access to memory tools.

Key facts

License	MIT — free forever
Platform	macOS · Linux · Windows
Language	Pure Rust (kernel) + Python (plugins)
Telemetry	None. Your data never leaves your machine
AI CLIs supported	Claude Code, Gemini CLI, Codex, OpenCode, Vibe, Cursor, Qwen, Kimi, pi
Plugins shipped	38 (core distro)
Version	0.1.6

Makakoo is local-first. The Brain lives at `~/MAKAKOO/data/Brain/` — plain markdown files you own. No account, no cloud sync, no telemetry.