Internal showcase · for Malkio

Ujima

A deployable, machine-enforced coordination layer for multi-agent AI teams. Ujima keeps everything that worked from two internal prototypes — folder-as-medium, agent sovereignty, snippet+reference, checkpoints — and moves everything mechanical into a deterministic, zero-dependency Python CLI so the protocol can't drift, race, or rot between sessions.

"LLMs make judgments; tools do bookkeeping. Any rule that can be enforced by code must never be enforced by prompt."

Surfaces

A surface is a whole place an agent — or Malkio — is in: a CLI session, a boot digest, a workspace on disk, a live fleet. These are rendered as full frames from the real CLI output, the real file layout, and one real deployed workspace, not mockups of a UI that doesn't exist.

01
The CLI
Everything an agent can do, straight from `ujima --help` — 19 subcommands under a "seven verbs" story.
02
ujima brief
The 11-step boot ritual, replaced by one command.
03
Workspace anatomy
The plain-file tree every agent reads and writes — no server, no database.
04
Convene / D.O.P.E.
Point agents at a target; the state machine that lets the team self-organize.
05
doctor + sweep
The health check and the housekeeping cron nothing in v1/v2 ever had.
06
The live fleet
caspera-fleet, the one real consumer — still running on collab-v3, not yet Ujima.

Component library

The pieces Ujima is assembled from — grouped by the job they do, not by directory. 47 components across 5 categories: every CLI subcommand, every schema, every template, every Convene phase, and every design doc.

⚙️
Verbs
The 19 CLI subcommands — boot, messaging, state, cadence & health, locking.
19 components
📐
Schemas
The four JSON Schemas that define every file the protocol reads or writes.
4 components
📄
Templates
The markdown scaffolds an operator fills in once per agent, kept as prose on purpose.
5 components
🧭
Convene / D.O.P.E.
The 11-phase state machine (design approved, not yet implemented) for self-organizing initiatives.
11 components
📚
Design docs
The eight documents that carry Ujima's reasoning — from intent to the five-year roadmap.
8 components

What this site is. Ujima has no UI — it is a protocol plus a 1,718-line zero-dependency CLI. There is nothing to screenshot. Every card below renders real CLI help text, real schema fields, real template excerpts and real doc copy, pulled from the files in this repo on 2026-07-18. The visual identity (dark panel chrome, the green/gold/red mark) is composed for this showcase — it is not extracted from a product design system, because the product does not have one. See README.md for the full faithful-vs-approximated accounting.