Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

CLI Reference

taba init

Initialize a local node. Generates an Ed25519 keypair, trust domain, and root governance unit.

taba init [--force] [--state-dir <DIR>]
FlagDefaultDescription
--forcefalseRe-initialize even if already initialized
--state-dir~/.tabaState directory (keypair, config, graph)

taba apply

Parse a TOML unit declaration, fill in identity, validate, and insert into the graph.

taba apply <FILE> [--dry-run] [--state-dir <DIR>] [--format <FORMAT>]
FlagDefaultDescription
--dry-runfalseValidate and display without inserting
--state-dir~/.tabaState directory
--formattableOutput format: table or json

taba unit list

List all active (non-archived) units in the graph.

taba unit list [--state-dir <DIR>] [--format <FORMAT>]

taba unit inspect

Show details of a specific unit.

taba unit inspect <ID> [--state-dir <DIR>] [--format <FORMAT>]

taba unit validate

Validate a TOML file without inserting into the graph.

taba unit validate <FILE>

taba unit archive

Archive a unit (soft-delete). Archived units are removed from the active set but retained for provenance integrity. Governance units cannot be archived (INV-G3).

taba unit archive <ID> [--state-dir <DIR>]

taba status

Show graph stats, operational mode, and node information.

taba status [--state-dir <DIR>] [--format <FORMAT>]

taba compose

Run the deterministic solver on the current graph. Shows placements, unplaceable units, and detected conflicts.

taba compose [--state-dir <DIR>] [--format <FORMAT>]

taba audit provenance

Show the provenance chain for a data unit.

taba audit provenance <UNIT-ID> [--state-dir <DIR>] [--format <FORMAT>]

taba audit trails

List all decision trails.

taba audit trails [--state-dir <DIR>] [--format <FORMAT>]

taba push

Push an artifact to the local peer cache. Computes SHA-256 and stores content-addressed.

taba push <FILE> [--cache-dir <DIR>]

taba-k8s convert

Convert K8s manifests to taba unit declarations.

taba-k8s convert <FILE> [--output-dir <DIR>] [--trust-domain <TD>] [--provenance]
FlagDefaultDescription
--output-dirstdoutDirectory for generated .taba.toml files
--trust-domain—Trust domain for generated units
--provenancefalseGenerate SLSA provenance placeholders