NEBULA
neb v0.1.0-pre.1·pre-alpha·protocol in design

VERSION CONTROL
BUILT FOR
AGENTS, NOT HUMANS.

Git assumes one person, one branch, one commit at a time.
Nebula assumes a dozen agents working at once —
each with its own workspace, review trail, and the
full context to pick up exactly where it left off.

agent workspace → change → proposal → policy → release → runtime

$neb request-access/go$neb help/go
nebula-registry

neb v0.1.0-pre.1 starting

────────────────────────────────────

[init] storage: canonical graph + blob store

[init] policy engine: loaded

[init] vector index: experimental

[init] git projection: compatibility mode

────────────────────────────────────

[ready] protocol listening

openedproposal prop_7x4a
composed3 agent workspaces
checkedpolicy merge passed
creatednebula://versions/v184
$neb save --message "Capture agent workspace"
$neb init
protocol / new primitives
$neb help

GIT STORES
PATCHES.
NEBULA STORES
SYSTEMS.

Git was designed to track files.
Modern teams need to track systems.
Nebula adds what Git cannot answer natively.

NEBULA PRIMITIVESpre-alpha
01

workspace

Isolated agent state. No branch names, stashes, or rebases.

neb workspace create billing --from main
02

change

Intent, affected services, review state, and result travel together.

neb save --message "Billing fix"
03

proposal

Structured review before work becomes history. Context, blockers, approvals.

neb propose --target main --title "Billing fix"
04

policy

Governance checked before history changes. Sensitive paths stay visible.

neb policy set "src/**" allow
05

projection

Git is a compatibility output of Nebula, not the source of truth.

neb projection export --environment production --target vercel
comparison / git vs nebula
$neb diff --model git

REVIEW
BEFORE
HISTORY
MUTATES.

Nebula reviews a proposal with context, blockers,
approvals, and signals attached before work
becomes history. Humans keep the final say.

git modelnebula modeldescription
commitversionfull agent run with artifacts, review state, and result
branchworkspaceisolated agent state without branch choreography or rebase
pull requestproposalstructured review before work is composed into history
rebasecompositionpolicy-aware merge of reviewed agent work
manifest / system status
$neb status --system
not production-ready
runtimepre-alpha protocol preview
canonicalgraph + blob store
projectiongit export is experimental
reviewproposal with attached context
policychecked before composition
vectorpath/hash index · semantic planned
statusnot production-ready

[WARNING] Do not use in production systems.

Pre-alpha: protocol and data models will break between versions.

NOT
A BLACK-BOX
PAAS.

Nebula's source of truth is a durable graph you can inspect, export, and move. GitHub, Vercel, local Git, and CI are projection targets — not the canonical record.

Metadata DB → repos, refs, snapshots, workspaces

Blob store → source bytes, encrypted private blobs

Vector DB → experimental path/hash index chunks

Policy → per actor, action, object, environment

ledger / active proposals
$neb proposal list
3 proposals
01

agent:billing

retry failed invoices without duplicate charges

ready
02

agent:security

rotate token storage and redact local env reads

policy hold
03

agent:docs

explain checkout recovery flow

queued
$neb request-access --email <your@email.com>
pre-alpha access

HELP SHAPE
AGENT-NATIVE
SOURCE CONTROL.

Nebula is a protocol preview for local workflows, policy-aware proposals, and experimental registry paths. Humans still keep the final say before history is composed.

→ teams building agent-native workflows

→ developers who think Git is not enough

→ infrastructure teams who need system-aware source control

$neb request-access/go$neb help --docs/go
$neb init

creating .nebula/

[ok]refs initialized

[ok]workspace: main

[ok]policy engine: ready

[ok]objects store: local

initialized nebula galaxy

$