NEBULA-DOCS(1)
Nebula is a pre-alpha version-control system for code, media, large objects, workspaces, proposals, policy-aware projections, and galaxy-scale history. These docs summarize the project internals into a product-facing guide.
Pre-alpha local loop
Get started
Build Nebula from source, initialize a local galaxy, save workspace state, and create your first proposal.
Source-control model
Core concepts
The foundational primitives that model source control separately from Git branches and commits.
Protocol primitives
Canonical model
How Nebula models source control without treating Git as the canonical data structure.
Governed history
Policies
Policy decisions control what actors can read, write, compose, export, or deploy.
Compatibility layer
Projections
GitHub, local Git, deployment platforms, and CI systems are outputs of policy-aware projection plans.
Migration and export
Git integration
Migrate existing Git repositories to Nebula and export Nebula state as Git commits.
Retrieval primitives
Vector indexing
Nebula is designed to be vector-native, but the current implementation is a path/hash index preview.
Configuration management
Environments and secrets
Manage environment-specific configuration with policy-controlled visibility.
neb command
CLI reference
Complete reference for the neb command-line interface.
Registry auth
Authentication
Authenticate with Nebula registries using Better Auth.
HTTP surface
Registry API
The registry API exposes protocol resources for galaxies, blobs, snapshots, proposals, projections, and schema discovery.
System design
Architecture
How Nebula separates source-control storage, policy, projections, and retrieval.
External systems
Integrations
Connect Nebula with external systems for authentication, collaboration, and deployment.
Pre-alpha status
Support matrix
The current state of capability support in Nebula.
Security model
Security
Security considerations for Nebula deployments.
Contributing
Development
Guidelines for developing Nebula.