cosmon

Noogram is an open system for running long AI-agent missions inside your own perimeter, keeping every step as plain files you own. Its kernel, cosmon, is a stateless CLI that gives each agent an identity, a lifecycle, and crash recovery.

The code lives at github.com/noogram/cosmon, open-core: the kernel, the CLI, and the runtime are AGPL-3.0-only, and the network SDK third parties link to talk to an instance over the wire is Apache-2.0 (LICENSE maps the split crate by crate). It is early-stage but functional — the core types, the cs CLI, state persistence, tmux transport, and the DAG engine all ship today, and the API is still moving, so expect breaking changes before 1.0.

• A social organization of agents. A long mission becomes small tasks, each with a precise goal. Agents take them on side by side, wait on one another when one task depends on another, and cross-examine each other's findings — panels, reviews, counter-arguments — before anything reaches you. Work at scale, the way a good team organizes itself.
• Runs inside your perimeter. The agent works on your corpus, on your machine. Every step, every decision, and every result is written to plain files on a disk you control. Only the model call leaves your machine — no server in the loop, no database, no Cosmon account.
• You stay the judge. The agent hands you a draft on its own branch, with its reasoning and evidence alongside; what the gates couldn't verify is marked unverified, never silently accepted. Nothing lands until it passes your gates.
• The story can't be quietly rewritten. Every mission leaves a complete, replayable work record. If anyone — human or agent — edits it after the fact without resealing it, cs verify notices. It catches a careless edit, not a determined forger.
• A crash is a pause, not a loss. Everything the agents record lives in those same plain files, so a fresh worker picks up where a crashed one stopped.
• A harness over the harnesses you already use: Claude Code, Codex, Aider, and other CLI agents; hosted APIs from Anthropic, OpenAI, Google Gemini, Mistral AI, Qwen, DeepSeek, GLM, Kimi, and more; or local models through llama.cpp and Ollama.
• Federate (under construction). Several machines cooperating on one mission, with no central owner.

noogram and its cosmon kernel

On a single machine, the tool you run is cosmon; its command is cs. You cs tackle a piece of work to start an agent on it, and cs done to close it out; the record of both lands under .cosmon/.

Noogram's ambition is a federated agentic system: many cosmon instances cooperating, each keeping its own record, with no single owner in the middle. The first brick is already here: the remote mode, where a cosmon-remote client talks to a cosmon-rpp-adapter service over HTTP(S) on another host. Broader peer-to-peer federation between instances is on the roadmap; the shape of that link is still being explored. That larger, cooperating whole is noogram; cosmon is its kernel. Today, run several agents in parallel on one machine and cosmon does that by itself, complete and standalone. See Noogram & the Cosmon kernel for the relationship, and Agent adapters for how a concrete agent or model plugs in.

Where to go next

• Want it running now? Install cosmon, then Ten minutes to cosmon takes you from an empty terminal to one merged piece of agent work.
• New here? The Explanation section is the conceptual on-ramp: the physics vocabulary, the kernel/distribution split, formulas and adapters and fleets, and how cosmon survives crashes. Start there.
• Learning by doing? The tutorials walk you from your first molecule to your first fleet to composing a DAG.
• Looking up a command? The CLI reference is generated from the tool itself, grouped by role. The full nucleate → tackle → wait → done cycle is covered in The three regimes.

This site is built by mdBook and rendered by the same pipeline that builds cosmon's own documentation.