clawft

WeftOS Documentation

Guides, references, and examples for WeftOS, the governed AI operating system.

WeftOS Documentation

WeftOS is an AI operating system written in Rust. This is documentation for v0.8.4. It is built in layers:

  • clawft is the agent runtime. It connects to hosted and local LLMs, runs tools and skills, and handles channels such as the CLI, web, Slack and Discord.
  • The WeftOS kernel provides processes, typed IPC, capability checks, constitutional governance, and an append-only hash chain (ExoChain) that records privileged actions.
  • ECC is the cognitive layer: a causal graph with vector search that gives agents persistent memory.
  • The node daemon (weaver) runs on each machine. It hosts a kernel per project, joins machines into a mesh, and runs cogs (sandboxed workloads, including sensor drivers) with governed placement.

Start Here

By Layer

Agent Runtime (clawft)

  • Getting Started: installation and first run
  • Agent Loop: how a message becomes a response
  • Providers: LLM providers, including local inference
  • Tools: built-in and custom agent tools
  • Channels: CLI, web, Slack, Discord and others
  • Security: sandboxing, SSRF protection, capability system

Kernel (WeftOS)

Cognitive Layer (ECC)

Release notes

See Release Notes for what changed in each release. Pages for the 0.8.x platform features (cogs, cogbus, placement, the tailnet router, projects) are being added; until they land, the repository's docs/guides/ and docs/adr/ directories are the reference.

On this page