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
Install
Release installer, Homebrew, Docker, crates.io or source, plus weaver update.
Quickstart
Initialize a project and boot a kernel.
Run your first agent
Configure a provider and talk to an agent with weft.
Architecture Overview
How the layers fit together.
LLM Providers
Hosted providers plus local servers such as Ollama.
Security Model
Sandboxing, SSRF protection, capabilities and governance.
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)
- Kernel Overview: boot sequence, services, feature flags
- Process Table: PID management and agent lifecycle
- Governance: constitutional governance with effect vectors
- ExoChain: cryptographic provenance and audit trails
- Mesh Networking: multi-node coordination
Cognitive Layer (ECC)
- ECC Overview: causal knowledge graph and semantic search
- DEMOCRITUS: the continuous cognitive loop
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.