CodeZaiku MCP server

CodeZaiku

A coding and development harness that runs on local models or hosted APIs, through real work: writing and maintaining code, reviewing diffs, operating a service stack, checking security posture, and researching questions against live sources.

Most agents like this assume a frontier model behind someone else's API. CodeZaiku is built the other way round — a 9B on hardware you own — and the harness does the work that makes that viable: deterministic evidence instead of model guesses, a guard stack around anything that acts, and verification with rollback on every change.

It runs against any OpenAI-compatible server and ships no weights. The reference tier is a 9B.

→ ARCHITECTURE.md — how it works → LIMITATIONS.md — the measured numbers

Quick start

You need an OpenAI-compatible model server, and a JDK 21+ unless you take a build that carries its own Java runtime (from 0.3.2, one per platform; the installer picks one when Java is missing). CodeZaiku ships no weights.

Linux is the supported platform. macOS runs the coding and research surfaces (and can operate remote Linux hosts over ssh); Windows works under WSL2. There is a container image. See PLATFORMS.md.

Three ways to use it

At a terminal, for yourself — carry on below; the commands are in What you can do with it.

Underneath another agent or orchestrator — CodeZaiku is a backend as well as a tool. It speaks a CLI-subprocess contract (codezaiku run), ACP (codezaiku acp) and MCP (codezaiku mcp). The contract, the result shape and the failure modes are in DEPLOYINGASABACKEND.md**; start there rather than here.

Underneath Wyrdsekai — CodeZaiku is released under the Wyrdsekai umbrella and is one of the coding backends Wyrdsekai can summon: you ask the companion for something, it hands the work to CodeZaiku. WITHWYRDSEKAI.md** is the short version of the page above — just the wiring, and the two things that trip people up. Nothing here depends on it; CodeZaiku runs standalone.

Installing

There is one binary artifact and it is platform-independent. CodeZaiku is JVM bytecode with no native parts, so the same tarball installs on Linux, macOS and Windows — there is no .pkg or .msi to look for, and none is needed.

Linux is the reference platform. macOS and native Windows are measured too, and the installer is verified on all three from a clean unpack. On Windows, install from Git Bash — the harness shells out through bash, and Git for Windows supplies it. See PLATFORMS.md for per-platform steps and for what does and does not work on each.

Linux and macOS:

curl -fsSL https://codezaiku.org/install | sh

Windows, from PowerShell (you also want Git for Windows — the harness shells out through its bash):

irm https://codezaiku.org/install.ps1 | iex

Shortened. The full README is on GitHub.