ZQK – An open-core substrate for autonomous agent swarms in Go

ZQK (Zen Quantum Kernel) launched as an open-core, distributed Cellular Knowledge Operating System written in Go, installable via Homebrew with `brew tap zqk-os/tap` and `brew install zqk`, with pre-compiled release archives and OpenVEX attestations on GitHub Releases. The project positions itself as a microkernel substrate for autonomous agent swarms, built on four primitives — the Cell/Holon, the Membrane state machine (Draft to Promoted via CAS membrane qualification), the Nervous System state bus, and the Organism P2P mesh — and ships CLI commands including `zqk init`, `zqk quickstart`, `zqk mcp install`, `zqk run`, and `zqk ui`. ZQK's developers argue that gluing agents together with Python scripts and vector databases causes context decay and hallucination, and offer cellular memory isolation and epistemic hygiene instead.

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 https://github.com/zqk-os/zqk/blob/main/docs/onboarding/COMMUNITY FIRST RUN.md . brew tap zqk-os/tap brew install zqk Pre-compiled release archives and OpenVEX attestations are available at GitHub Releases https://github.com/zqk-os/zqk/releases/latest . 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 Cursor stdio: zqk mcp cursor-adapter Run a portable swarm package local path or remote git URL zqk run ./examples/swarms/code-eval/ Or run from remote git: zqk run https://github.com/zqk-os/swarm-starter-kit Launch interactive full-screen terminal mission control zqk ui Stream real-time mutations with the visual ANSI seismograph 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: 1. 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. 2. 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. 3. 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. 4. 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 vs Promoted , 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 alias zgrep . - 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 https://docs.zqk.dev/docs/onboarding/COMMUNITY FIRST RUN — Recommended starting point for humans and agents. - First-Run Object Tutorial https://docs.zqk.dev/docs/onboarding/FIRST RUN OBJECT TUTORIAL — Creating and managing kernel objects. - Quickstart & MCP Setup https://docs.zqk.dev/docs/onboarding/QUICKSTART — Connecting Cursor, Claude Code, and other LLMs. - Architecture Guide https://docs.zqk.dev/docs/architecture/README — Deep dive into the cellular microkernel architecture. - Contributing https://github.com/zqk-os/zqk/blob/main/CONTRIBUTING.md — Development guidelines and PR policies. - Security Policy https://github.com/zqk-os/zqk/blob/main/SECURITY.md — Vulnerability reporting and fail-closed security guarantees. - Website: zqk.dev https://zqk.dev - Documentation Portal: docs.zqk.dev https://docs.zqk.dev - General Inquiries: inquiry@zqkos.com mailto:inquiry@zqkos.com - Technical Support: support@zqkos.com mailto:support@zqkos.com - Schedule a Call: Book a ZQK Inquiry https://calendar.app.google/VhhrKgXqrukr48Kg7 - GitHub: zqk-os/zqk https://github.com/zqk-os/zqk Open-Core Community Kernel: Apache License 2.0 https://github.com/zqk-os/zqk/blob/main/LICENSE see NOTICE . Enterprise modules and multi-node fleet mesh capabilities are licensed separately.