CLI reference | Nebula Docs

NEBULA-CLI(1)

Nebula Manual

NAMEcli reference — Complete reference for the neb command-line interface.

SOURCEnebula/crates/nebula-cli/src/main.rs

STATUSpre-alpha · protocol in design

Global options

Options that apply to all commands.

output

neb [--json] [--quiet|-q] [--verbose|-v] [--no-color] <command>

--json       Output JSON instead of human-readable format
--quiet, -q   Suppress non-essential output
--verbose, -v Enable verbose logging
--no-color    Disable ANSI color output

Repository initialization

Initialize a new Nebula repository or clone from a remote.

output

neb init                              # Initialize in current directory
neb clone <remote>                   # Clone a remote galaxy
neb clone https://registry.example.com/repo_abc123.neb

Status and diff

Inspect the current state of your workspace.

output

neb status                            # Show workspace and changes
neb diff                             # List changed files with kinds

Save and sync

Save workspace state as a canonical snapshot.

output

neb save --message "Fix auth redirect"  # Save current state
neb push [remote]                    # Push to remote registry
neb pull [remote]                   # Pull from remote registry

Remotes

Manage remote registry connections.

output

neb remote add <name> <url>           # Add a remote
neb remote list                       # List configured remotes
neb remote remove <name>              # Remove a remote

Workspaces

Create and manage isolated work contexts.

output

neb workspace create <name> --from <ref>  # Create from ref
neb workspace list                       # List all workspaces
neb workspace switch <name>             # Switch active workspace
neb workspace dirty <path>              # Mark path as modified

Proposals

Create and manage proposals for review.

output

neb propose --target <ref> --title "<title>"  # Create proposal
neb proposal list                              # List proposals
neb proposal status [proposal-id]             # Show proposal state
neb proposal close <proposal-id>              # Close a proposal
neb merge <proposal-id>                       # Merge proposal into target

Refs

Manage named references to snapshots.

output

neb ref list                          # List all refs
neb ref show <name>                   # Show ref details

Policies

Create and evaluate policy decisions.

output

neb policy set <path> <decision>      # Set policy (allow, redact, omit, block)
neb policy list                        # List all policies
neb policy check <path> <action>      # Check policy for path/action

010

Environment variables

Manage environment-specific configuration.

output

neb env list [--environment <name>]   # List environments or vars
neb env create <name>                 # Create environment
neb env configure <name>              # Configure environment
neb env set <key> [--value <val>] [--environment <env>] [--sensitive] [--sealed]
neb env seal <key> [--environment <env>]  # Seal a variable
neb env export [--environment <env>]  # Export as shell vars
neb env diff                          # Diff local environments

011

Secrets

Manage secret references for deployment.

output

neb secret add <name>               # Add secret reference
neb secret inject <name> --environment <env>  # Plan injection

012

Vector operations

Index and search across snapshots.

output

neb vector index [--snapshot-id <id>] [--remote <remote>]
neb vector search <query> [--manifest-id <id>] [--remote <remote>]
neb vector explain <path> --manifest-id <id> [--remote <remote>]

013

Git operations

Mirror, migrate, and export Git repositories.

output

neb git mirror <remote> --mirror-path <path>
neb git migrate <repo> [--namespace <ns>] [--lfs pointers]
neb git import <remote> [--execute] [--mirror-path <path>]
neb git export <target> [--execute] [--worktree <path>]
neb git pr <proposal-id>

014

Projections

Preview and export policy-aware projections.

output

neb projection preview --environment <env> --target <target>
neb projection export --environment <env> --target <target>

015

Galaxy operations

Create and manage galaxies (repositories) on a registry.

output

neb galaxy create <name> [--registry-url <url>] [--remote <remote>] [--org <org-id>]

016

Integrations

Manage external integrations.

output

neb integration add <provider>       # Add integration
neb integration configure <provider>  # Configure integration
neb integration test <provider>       # Test integration connection

017

Ops commands

Operational commands for registry maintenance.

output

neb ops migration                      # Show migration plan
neb ops consistency check              # Check data consistency
neb ops consistency repair [--execute]
neb ops retention plan                 # Show retention plan
neb ops retention cleanup [--execute]
neb ops backup plan --metadata-uri <uri> --blob-uri <uri>
neb ops restore plan --metadata-uri <uri> --blob-uri <uri>

018

Shell completions

Generate shell completions for better CLI ergonomics.

output

neb completions bash > /etc/bash_completion.d/neb
neb completions zsh > ~/.zsh/completions/_neb
neb completions fish > ~/.config/fish/completions/neb.fish

019

Man page

Generate a man page for the CLI.

output

neb man > neb.1
man neb.1