Kambadiame

A personal AI friend that lives on your computer. Coding-first, expanding to email, docs, research, and more. One daemon, one PWA, one terminal TUI. Claude Code's core ported and extended, with multi-model routing via OpenRouter.

Status: Architecture reframed 2026-04-17 per TASK-011. Week 1 of 8 in progress.

Not a team tool. Not a SaaS. Each user runs their own instance locally.

Quick start

pnpm install
pnpm dev
# -> "kambadiame daemon starting..."

Currently: a placeholder daemon that prints a hello line. TASK-012 replaces the stub with the real agent core.

Architecture at a glance

• One Node.js daemon hosting everything: agent core, gateway (HTTP + WS), kanban, memory, tools, permissions, SQLite storage.
• Two surfaces — Terminal TUI at the desk, PWA (installable on phone) for chat/kanban/docs/approvals. Same daemon behind both.
• Multi-agent inside — main agent spawns subagents via AgentTool (fork/fresh, Claude Code pattern). Lane concurrency (OpenClaw): serial per task, parallel across tasks.
• LLM: OpenRouter primary, fallback chains, model routing (strong/default/fast/local).
• Storage: SQLite (WAL mode) + filesystem. No Postgres, no Redis, no Docker.

See CLAUDE.md for the full architectural detail, patterns to follow, and the 300-line-per-file rule.

Directory layout

kambadiame/
├── src/
│   ├── daemon.ts              # entrypoint
│   ├── agent/                 # query, engine, tool, registry, system-prompt, KAMBA.md, permissions, compaction
│   ├── gateway/               # HTTP + WS server, protocol, methods, broadcast
│   ├── llm/                   # OpenRouter client, router, fallback
│   ├── tools/                 # file-read/write/edit, glob, grep, bash, kanban-*, web-*, memory-*, agent-tool
│   ├── kanban/                # 4-column state machine (INBOX/DOING/WAITING_ON_ME/DONE)
│   ├── memory/                # auto-memory, session memory, MagicDocs, auto-dream
│   ├── repo-map/              # tree-sitter + PageRank
│   ├── safety/                # safe/dangerous command lists, safety checks
│   ├── skills/, hooks/, storage/, edit/
├── apps/
│   ├── pwa/                   # Vite + React PWA (TASK-025, -026)
│   └── tui/                   # terminal TUI (TASK-017)
├── kanban/                    # file-based kanban for building Kambadiame itself
├── _reference/                # archived pre-reframe scaffolding (see _reference/INDEX.md)
├── CLAUDE.md                  # project instructions (→ KAMBA.md after TASK-014)
├── package.json, tsconfig.json, .env.example, .nvmrc, .gitignore
└── README.md

The 8-week plan

Phased in TASK-011 and tracked in kanban/:

• Week 1 — TASK-012 agent core port, TASK-013 OpenRouter client, TASK-014 KAMBA.md + system prompt, TASK-015 core tools
• Week 2 — TASK-016 gateway WS, TASK-017 terminal TUI, TASK-018 permissions + safety
• Week 3 — TASK-019 repo map, TASK-020 EditBlock + auto-commit
• Week 4 — TASK-021 memory, TASK-022 compaction
• Week 5 — TASK-023 skills, TASK-024 kanban + SQLite + web tools
• Weeks 6-7 — TASK-025 PWA chat + kanban, TASK-026 PWA docs + approvals
• Week 8 — TASK-027 AgentTool + hooks, TASK-028 model routing + MagicDocs + polish

Source attribution

Kambadiame is stitched from five analyzed projects. See _reference/INDEX.md for files that feed each task directly.

| Source | Share | Gives it | |---|---|---| | Claude Code | 60% | Core loop, tools, permissions, skills, memory, hooks, compaction | | OpenClaw | 15% | Gateway WS protocol, lanes, transcripts | | Aider | 10% | Tree-sitter repo map, PageRank, EditBlock | | Codex | 5% | Safe/dangerous command lists, native sandbox | | OpenCoder | 5% | CoderTool type, widget rendering | | Gemini CLI | 5% | MCP client, confirmation bus |

Reference scaffolding

The original microservices implementation (Feb 2026) lives in _reference/ — not live code, but mined for algorithms, Zod schemas, and test cases. See _reference/README.md and _reference/INDEX.md.

License

Apache-2.0