Wakilarium · open source · Apache 2.0

Watch your agents work.

One aquarium for any AI agent: Claude Code, OpenTelemetry, Zelij Core, the agents of your own platforms. An open event format, a dependency-free web component, a tiny collector. Your data stays home.

Lire cette page en français →

$ npx wakilarium  # starts the collector on your machine and opens the scene

The scene: a simulated day

The Wakilarium scene: the human in gold at the centre of the direction lane, one glowing agent per lane, a dashed visitor at the entrance, dialogue cards linked by flowing threads.

Simulated day, fictional characters. In your installation, every card is a real event emitted by your own agents, visible live and replayable. Gold is the human: nothing that commits happens before their decision. The dashed visitor is an external agent, a shopping agent for instance, anonymous by default.

One event, one line.

A Wakil Event says who did what, when, to whom, at what cost and in what state. What is private stays private: only the public title may appear on a shared page.

{"v":"0.1","ts":"2026-10-19T10:05:00+02:00","kind":"decision.open",
 "actor":{"id":"chef","name":"Camille Aubert","role":"chief of staff","lane":"direction"},
 "target":{"id":"founder"},
 "title":"Publish the offer page? Options, risks and rollback are in the package.",
 "public_title":"proposes a decision","status":"pending"}
kindrun.start · run.end · tool · message · decision.open · decision.made · visitor · launch · cost · note
actorid, name, role, lane, kind (agent · human · service · visitor). The human is drawn in gold.
privatetitle, detail, attrs, cost: never on a public view. public_title or a generic label, nothing else.

Plug in with one line.

The collector receives events, stores them, serves them to the component. Adapters translate what you already have.

Claude Code · Agent SDKOne commandnpx wakilarium hook install: sessions, tools and subagents become Wakil Events. No file read, no secret, reversible.
Zelij CoreAlready insideThe Zelij Core office stages its four agents with this format, live and in replay.
OpenTelemetry GenAI · AG-UIIn preparationAgent, tool and model spans projected without copying prompts; the agent → UI protocol, staged.
Your platformsOne POSTSend your events to the collector, show the component in your page. Zero dependencies, Node 18 or later.
# local collector, zero dependencies
npx wakilarium                 # 127.0.0.1:8798, opens the page
npx wakilarium hook install    # your Claude Code sessions
<!-- the component, in your page -->
<script type="module" src="https://cdn.jsdelivr.net/npm/wakilarium@0.1.1/src/wakilarium.js"></script>
<wakil-arium src="http://127.0.0.1:8798/state" theme="night"></wakil-arium>

The principle

Your data stays home.

The collector runs on your machine or your server. It makes no outbound calls and executes nothing: it stores and it shows. The public page is a projection without detail, that you open and cut with one click.

  • Apache 2.0: embed it in your products, open or closed.
  • Zero dependencies: a Canvas 2D component, a Node collector, nothing else to install.
  • Reduced motion respected: the scene stays still but keeps its depth.

And around it.

Zelij Core, the office that goes with it

Four agents who propose, one founder who decides, and the aquarium to watch them work. Free edition, installed with one command.

A star, an adapter, an idea

The repository is open to contributions: an adapter for your harness, a theme, a fix. Releases and the roadmap are published with the code.

Wakilarium is published under the Apache 2.0 license by zelij.ai. The brand and the hosted demo stay with zelij.ai; the format and the code belong to everyone.