cos — component docs

Summary documentation for the cos daemon family, one page per component. The canonical home of these pages is docs/_man/ in the public markc/cos repo; add a page by dropping COMPONENT.md there. The same files render three ways:

  • Web — markc.github.io/cos serves this manual in the site's left-hand Components pane; any page deep-links as #_man/PAGE.md.
  • GitHub — browse docs/_man/ directly; this file doubles as the directory README.
  • Local clone — plain markdown with relative links; any editor or viewer works.

These are summaries — what each component is and how to use it — not exhaustive manpages. For the language that drives these daemons, see the mix manual.

Start here

  • overview — what cos is, how the workspace is laid out, how it fits with bus and mix.

Daemons

  • noded — the Bus broker; every node runs one.
  • maild — JMAP-native mail daemon (SMTP + IMAP + JMAP + spam).
  • webd — multi-vhost HTTPS + ACME; server-rendered web UI.
  • dnsd — authoritative WireGuard-mesh DNS.
  • indexd — vector knowledge base / indexer.
  • desktop — the CosMix desktop: cosmix-comp (Smithay + Bevy Wayland compositor), the ctk toolkit and the native apps.
  • cosmix-comp — Wayland compositor and supported protocol globals.
  • quoin — corner-driven desktop panels with standalone SCTK and experimental compositor hosts.
  • cosmix-bg-showcase — shared Bloom, Shapes, Boing and Boids demos with native Bus controls.
  • cosmix-capture — native Wayland screenshots and full-output MP4 recording controlled through Bus.
  • cosmix-media — native CTK MP3/MP4 player with PipeWire-compatible audio and Bus playback controls.
  • cosmix-wallpaper — GPU-rendered flocking background with window avoidance, pointer repulsion and native Bus preferences.
  • agentd — agent supervision.
  • powerd — event-driven UPower battery and power state.
  • mprisd — event-driven MPRIS2 media-player state and delegated controls.

Bridge & libraries

  • foreman — task runner, policy gate, verifier, and refinery operator runbook.
  • mcp — the Claude Code MCP bridge.
  • libraries — the shared cosmix-lib-* substrate crates.

See also