The Cellular Knowledge Operating System for autonomous agent swarms. This repository is ZQK Core, the open-core community microkernel. Canonical portal: Community First-Run Guide.
brew tap zqk-os/tap
brew install zqk
Pre-compiled release archives and OpenVEX attestations are available at GitHub Releases.
git clone https://github.com/zqk-os/zqk.git && cd zqk
make # → ./bin/zqk
./bin/zqk --version
mkdir my-project && cd my-project
zqk init
zqk quickstart
Do not export ZQK_PROJECT_ROOT in your shell profile. ZQK discovers the nearest .zqk/ membrane from the working tree.
zqk system agent-onboard --format json
zqk system start-here
zqk mcp install
zqk mcp ensure --tcp 127.0.0.1:8443
zqk run ./examples/swarms/code-eval/
zqk ui
zqk state stream --dashboard
The Substrate for Living Software: Sovereign Cells. Verified Truth. Autonomous Organisms.
ZQK (Zen Quantum Kernel) is an open-core, distributed Cellular Knowledge Operating System (Cellular OS) engineered in high-performance Go. It fundamentally rejects the status quo of gluing autonomous agents together with fragile Python scripts and chaotic vector swamps.
Instead, ZQK treats multi-agent systems as a biological computing substrate built upon a rigorous microkernel architecture: where individual repositories and services function as autonomous holons—sovereign, self-governing wholes that integrate seamlessly into a collaborative distributed organism.
Your AI agents are coding blind. Dumping uncurated conversation logs into vector lakes produces context decay and runaway hallucination blast radiuses. ZQK provides cellular memory isolation, epistemic hygiene, ambient feedback sensing, and biological self-healing guardrails so agent swarms govern themselves.
Rather than treating multi-agent work as loose prompt scripts or terminal splits, ZQK introduces four foundational biological primitives:
- The Cell / Holon (Sovereign Node): Each ZQK kernel is an autonomous holon—simultaneously a complete, self-governing whole and an organic participant in the wider mesh. It maintains authoritative stewardship over its local codebase, tests, and private knowledge graph without relying on bloated global vector lakes.
- The Membrane (Deterministic Boundaries): A strict multi-plane state machine (
Draft→Promoted(via CAS membrane qualification)) ensuring that zero unverified agent mutations ever pollute working code or canonical state. - The Nervous System (Active Operational Graph): An active, real-time synaptic state bus driving task execution, causal provenance lineage, and dependency trees—not a passive secondary data lake.
- The Organism (Inter-Cellular Mesh): Domain-expert kernels communicating over a typed P2P wire protocol to achieve compound objectives without central micromanagement.
Knowledge in ZQK is never static documentation. It is an active, sensing memory layer:
- Programmed Human Intent: Human goals, non-negotiable rules, architectural invariants, mission, and vision are encoded directly into kernel schema objects (
Goal,Policy,InvariantGate). Agents never invent objectives in isolation; their actions are strictly bounded by human-imparted intent. - Ambient Feedback Sensing: Integrated background daemons monitor filesystem changes, test execution suites, and process drift. The kernel senses when reality diverges from intent and dynamically triggers corrective cycles.
- Temporal Agility (Snapshot, Rollback & Cherry-Pick): Treat knowledge like Git commits. Create atomic cryptographic snapshots, fork or branch memory planes for parallel experimentation, rollback failed excursions, and cherry-pick verified knowledge across cells.
- Laser Context Curation & Token Efficiency: Rather than exhausting LLM context windows on uncurated chat history, ZQK slices precise graph subtrees based on the specific WorkUnit an agent claims—significantly reducing token consumption while maximizing reasoning accuracy.
| Layer | System Tier | Responsibilities |
|---|---|---|
| Layer 3 | Domain Workflows & Applications | Software Engineering Profile, Security Ops Enclaves, Custom Enterprise Swarms |
| Layer 2 | The Kernel Standard Library (Core DNA) | Goal (Objective),BacklogItem (BLI / WorkUnit),InvariantGate (Verification),Decision (ADR) |
| Layer 1 | Microkernel Runtime Engine | Graph State Bus, Multi-Plane Isolation ( Draft vsPromoted ), Deterministic Scheduler, IPC Protocol |
ZQK follows the classical operating system boundary: POSIX/Kernel primitives are 100% open-source; distributed multi-tenant mesh clustering and fleet governance are commercial.
| Dimension | ZQK Core (Open-Source Community) | Enterprise Fleet Mesh |
|---|---|---|
| Scope | Single Autonomous Cell (Local Kernel) | Multi-Node Mesh Orchestration & Fleet Governance |
| State & Engine | Go microkernel, local hybrid file + graph store, local validation | Cross-cell routing, multi-tenant directory, global trust topology |
| Task Lifecycle | Self-contained task loop, local self-healing, deterministic planes | Fleet-wide apoptotic quarantine, cross-cell task delegation |
| Codegen & Specs | Core DNA schemas, public object parser, manual/template bindings | Fleet Spec-Driven Codegen Engine, automated AST synthesis |
| Governance & Ops | Single-node CLI dashboard, Git CAS integrity gates | Enterprise RBAC, cross-cell compliance audit trails, global telemetry |
-
Cellular Epistemic Hygiene: Cryptographic provenance (
parent_hash,agent_id,signature) attached to all mutations. -
Autonomous Project Awareness: Agents query the graph to discover objectives, constraints, and architecture without manual prompting.
-
Native Code Search: High-performance in-process AST and trigram search via
./bin/zqk grep(aliaszgrep). -
Local-First & Offline-Ready: Pure Go with filesystem & embedded graph storage—zero external cloud dependency required.
-
Deterministic Traceability: Every commit and diff links back to verified invariants and backlog work units.
-
Community First-Run Guide — Recommended starting point for humans and agents.
-
First-Run Object Tutorial — Creating and managing kernel objects.
-
Quickstart & MCP Setup — Connecting Cursor, Claude Code, and other LLMs.
-
Architecture Guide — Deep dive into the cellular microkernel architecture.
-
Contributing — Development guidelines and PR policies.
-
Security Policy — Vulnerability reporting and fail-closed security guarantees.
-
Website:zqk.dev
-
Documentation Portal:docs.zqk.dev
-
General Inquiries:inquiry@zqkos.com
-
Technical Support:support@zqkos.com
-
Schedule a Call:Book a ZQK Inquiry
-
GitHub:zqk-os/zqk
Open-Core Community Kernel: Apache License 2.0 (see NOTICE). Enterprise modules and multi-node fleet mesh capabilities are licensed separately.