nokv / docs
Documentation
NoKV is a distributed workspace and artifact store for multi-agent systems. It gives inputs, scripts, outputs, logs, metadata, and provenance stable path-shaped identities, publishes immutable bodies in S3-compatible storage, and keeps workspace versions, discovery, recovery, references, and GC in a root-routed metadata control plane.
Status shard-local guarantees · one active owner per logical shard · no cross-shard transactions · production metadata HA not qualified
Core
What NoKV is, how it is built, and the surface agents speak.
Architecture
How NoKV routes Agent workspaces through a fenced metadata control plane and stores immutable artifact bodies in S3-compatible storage.
Product Design
The product boundary for NoKV's distributed Agent workspaces, metadata control plane, immutable artifacts, and supported interfaces.
Agent Interface
Reference for NoKV's exact 18-tool Workbench contract across the native CLI, direct SDKs, and optional stdio MCP sidecar.
Storage
How namespace records and immutable artifact bodies are laid out and kept honest.
Metadata Schema
The format-10 path-native schema: RootId routing, visible workspaces, immutable artifact revisions, and fenced metadata commands.
Object Layout
Revision-owned immutable artifact blocks, manifest publication, strong references, and provider admission.
RustFS Backend
RustFS as an optional local S3-compatible provider profile, with durable namespace binding and write-conformance admission.
Operations
How snapshots, commits, restore, and engineering evidence are qualified.