AgentDrive

A local-first Drive for agent swarms. Content-addressed memory, capability-gated sharing, multi-device federation — and no central authority anywhere in the stack.

Install Source on GitHub

First launch

`agentdrive` opens the welcome screen with current pool state, policy summary, and the next operator actions.

Command surface

Installation and launch

Live

Install

curl -fsSL https://vektraindustries.com/agentdrive/install | bash

Launch

agentdrive

Runtime notes

One command. Local-first Drive for agent swarms — content-addressed Genomes, sibling-learning, capability-gated access. Works on Linux, macOS, and WSL.

What it does

A Drive built for how agents actually share memory.

Every cloud drive ever shipped assumed humans, opaque bytes, and a central server. AgentDrive assumes none of those — and what changes is the whole stack.

Content-addressed Genomes

Every artifact is a SHA-256 of its canonical JSON. Dedup is free, lineage is a DAG, provenance is cryptographic.

Shared swarm Drive

Sub-agents in the same swarm read each other's work by default. The sibling-learning primitive without ACL bookkeeping.

Capability URIs

One access primitive across local store, swarm, and peer federation. Possession of the cap is authorization.

CRDT + conflict copies

Commutative counters merge automatically. Non-commutative writes become first-class conflict copies — contradictions are data, not bugs.

P-384 trust circle

Multi-device sync without a central authority. Voucher-based join, sealed sync envelopes, no recovery backdoor.

Promotion gates

Every cross-tier ingest is an auditable propose/approve record. Self auto-approves; trusted peers are opt-in.

Operator flow

Install, launch, federate.

three commands · zero ceremony

Install

One curl command brings up the CLI, the TUI, and the shared object store in a venv that does not collide with system Python.

Launch

Run `agentdrive` to open the terminal surface with the current pool state, policy summary, and the next operator actions.

Federate

Form a trust circle with another device, exchange vouchers, sync swarm Drives over signed + encrypted envelopes.

Surface area

One Drive, four entry points.

CLI

Inspect, ingest, query, snapshot, and federate from the terminal.

TUI

Interactive surface for onboarding, pool review, and policy tuning.

Web

FastAPI + HTMX pages for Drive / Swarms / DNA / Snapshots / Capabilities / Peers.

Adapters

Drop AgentDrive into Claude Code, Codex, Grok Build, or any orchestrator that spawns children.

Policy model

The rules stay visible, not implied.

Pools start empty and only accumulate proven material.
Sharing rules are explicit instead of being inferred from runtime behavior.
Every retained Genome carries a verifiable author + lineage.
Cross-tier ingest requires an explicit promotion record — auditable and revocable.