cosmix
An agent-operable computing substrate
Not a desktop with AI features — an AI-first substrate that currently manifests as a Linux desktop and a sovereign mesh service stack. State is queryable as structured data, config is mutable through AMP verbs and property writes, and the whole system is buildable and reconstructible from a clean clone. Three public repos, one manual.
A substrate designed to be operated by agents
Legible, modifiable, and reconstructible — by design, and by an AI agent as a first-class operator
cosmix takes its lineage from AmigaOS / ARexx (everything is a message port), the Smalltalk and Lisp machines (a live, self-reflective image), and Plan 9 (everything is a namespace). The novel contribution is the AI agent as first-class operator of self-observation, self-modification, and self-rebuilding. Every architectural decision is filtered through three questions.
More legible to agents?
- State queryable as structured data
- Code paths introspectable
- Schemas agent-readable
More modifiable by agents?
- Config through structured channels
- AMP verbs and property writes
- Lifecycle agent-operable
More reconstructible?
- Build system agent-operable
- Components hot-swappable where safe
- The system can rebuild itself
Three repos, one dependency order
amp ← mix ← cos — each layer builds on the one before it
amp — the protocol
The Agent Mesh Protocol: a pure-Rust library family for messaging across a WireGuard-secured mesh. Named, addressable ports; send, call, subscribe. Depends on nothing.
mix — the language
An ARexx-inspired, AMP-native language and shell — cosmix's control surface. The thing you script, glue, and drive the mesh with. Builds on amp.
Read the mix manualcos — the daemons
The daemon family that runs a mesh node: broker, mail, web, DNS, knowledge indexer, display compositor, agent runtime, MCP bridge — plus the substrate libraries they share. Builds on amp and mix.
Read the cos manualPublic, buildable, self-hosting
Everything here builds from a clean clone — no hidden state
The three repos are public on GitHub. amp builds standalone; mix depends on amp; cos depends on both. This site — the manual you are reading — is itself a plain static tree of markdown rendered client-side, served from markc/cosmix.