https://github.com/markc/cos
Cosmix daemons + their substrate libraries (broker, mail, web, DNS, indexing, display, MCP, agent + shared libs)
https://github.com/markc/cos
Last synced: about 2 months ago
JSON representation
Cosmix daemons + their substrate libraries (broker, mail, web, DNS, indexing, display, MCP, agent + shared libs)
- Host: GitHub
- URL: https://github.com/markc/cos
- Owner: markc
- License: mit
- Created: 2026-05-29T04:06:09.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-29T05:14:38.000Z (about 2 months ago)
- Last Synced: 2026-05-29T07:16:49.249Z (about 2 months ago)
- Language: Rust
- Size: 2.01 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# cos
**cos** is the cosmix daemon family: every Rust crate that runs a node in a cosmix mesh — broker, mail, web, DNS, knowledge indexer, display compositor, agent runtime, MCP bridge — plus the substrate libraries they share.
27 workspace members: 13 substrate libraries, 13 daemon-family crates (long-running daemons plus their helper / CLI subcrates), and 1 mesh-aware app (`cosmix-mail`).
## What's in here
### Substrate libraries (`src/crates/cosmix-lib-*`)
| Crate | What it is |
|---|---|
| `cosmix-lib-config` | `node.toml` loader, per-daemon settings, opt-in `client-helpers` for broker auto-resolve. |
| `cosmix-lib-daemon` | Daemon framework: `init_tracing`, `http_host`, graceful shutdown; optional `tls` feature (rustls + ACME + SNI resolver). |
| `cosmix-lib-props-store` | SPEC 12 substrate surface — sqlite / memory storage backends, audit HMAC, namespace lifecycle. Pairs with `cosmix-lib-props-core` in [amp](https://github.com/markc/amp). |
| `cosmix-lib-mesh`, `cosmix-lib-mesh-trust` | Mesh peering + cross-mesh authz. |
| `cosmix-lib-log` | SPEC 12 `log` namespace + per-daemon `LogHandle::attach_props` watcher. |
| `cosmix-lib-node-id`, `cosmix-lib-wg` | Node identity + WireGuard config helpers. |
| `cosmix-lib-skills`, `cosmix-lib-agent`, `cosmix-lib-llm` | Agent runtime building blocks. |
| `cosmix-lib-display` | Display-protocol consumer (markdown-over-AMP UI). |
| `cosmix-lib-dns` | Authoritative DNS codec library used by `cosmix-dnsd`. |
### Daemons + helpers (`src/crates/cosmix-*d`, `cosmix-mcp`, `cosmix-claud`, `cosmix-mds`, `cosmix-maild-*`)
Long-running daemons:
| Binary | What it does |
|---|---|
| `cosmix-noded` | AMP broker. Every mesh node runs one. |
| `cosmix-maild` | JMAP-native mail daemon (SMTP + IMAP + JMAP + Bayesian classifier). |
| `cosmix-webd` | Multi-vhost HTTPS + ACME. |
| `cosmix-dnsd` | Authoritative WG-mesh DNS. |
| `cosmix-indexd` | Vector indexer / knowledge base. |
| `cosmix-disp-skia` | Display-protocol Skia compositor (winit + softbuffer + tiny-skia + cosmic-text). |
| `cosmix-agentd` | Agent supervision. |
Helpers + adapters (not long-running daemons themselves):
| Crate | What it is |
|---|---|
| `cosmix-mcp` | Claude Code MCP bridge — exposes cosmix surfaces as MCP tools. |
| `cosmix-claud` | Claude SDK agent runtime adapter. |
| `cosmix-mds` | Mail data store helper used by `cosmix-maild`. |
| `cosmix-maild-auth` | Authentication library for `cosmix-maild` (no binary). |
| `cosmix-maild-rules` | Filter engine library + CLI subcrate. |
| `cosmix-maild-bayesian` | Spam classifier library + CLI subcrate. |
### Apps (`src/crates/cosmix-mail`)
`cosmix-mail` — a mesh-aware JMAP mail client. Reads / composes / sends via a local or remote `cosmix-maild`; renders through `cosmix-disp-skia`.
## Building
cos needs two sibling repos: [amp](https://github.com/markc/amp) (the AMP protocol library) at `~/.amp/`, and [mix](https://github.com/markc/mix) at `~/.mix/` (the strict-data parser in `cosmix-lib-mix` is consumed by five cos-side crates: `cosmix-lib-config`, `cosmix-lib-dns`, `cosmix-claud`, `cosmix-mcp`, `cosmix-maild`).
```sh
git clone https://github.com/markc/amp ~/.amp
git clone https://github.com/markc/mix ~/.mix
git clone https://github.com/markc/cos ~/.cos
cd ~/.cos/src && cargo build --workspace --release
```
Tests:
```sh
cd ~/.cos/src && cargo test --workspace
```
Lints:
```sh
cd ~/.cos/src && cargo clippy --workspace --all-targets -- -D warnings
```
## Installing
Daemon binaries install to `/opt/cosmix/bin/`:
```sh
sudo install -m 0755 ~/.cos/src/target/release/cosmix-noded /opt/cosmix/bin/
sudo install -m 0755 ~/.cos/src/target/release/cosmix-maild /opt/cosmix/bin/
# ... repeat per binary
```
SPEC-10 daemon identities (system users / UIDs) install from the bundled sysusers fragment:
```sh
sudo install -m 0644 ~/.cos/src/_etc/sysusers/cosmix.conf /usr/lib/sysusers.d/cosmix.conf
sudo systemd-sysusers --create
```
Per-daemon systemd units are not currently shipped in this repo (only the SPEC-10 sysusers fragment is). Operators provide their own units, or generate them from each daemon's `cosmix-X --help` and the user-name list in the sysusers fragment.
## Configuration
Each daemon reads `/etc/cosmix/node.toml` (system) or `~/.config/cosmix/node.toml` (per-user) for shared node config, plus its own per-daemon config under `/etc/cosmix//config.toml` where applicable. `cosmix-lib-config` defines the schema; see each daemon's source for the per-daemon block.
## Related projects
- **[amp](https://github.com/markc/amp)** — the Agent Mesh Protocol library family that every cos daemon links against.
- **[mix](https://github.com/markc/mix)** — the ARexx-flavoured scripting language with first-class AMP keywords; the natural way to script + orchestrate cos daemons.
## License
MIT. See `LICENSE`.