sgit dev
Dev/perf instrumentation tools (sgit dev <tool>).
Generated from sgit help all --format json, sgit-ai v0.23.0. 26 subcommands below. To change this page, change the command's register() in the CLI and regenerate.
sgit dev
Subcommands
sgit dev cat-object
Decrypt and display object contents
sgit dev cat-object [options] <object_id>
| Argument | | What it is |
|---|
object_id | required | Object ID (12-char hex) |
| Option | What it does |
|---|
--directory, -d | Vault directory (default: .) |
--vault-key | Vault key (auto-read from .sg_vault/local/vault_key if omitted) |
sgit dev debug
Enable or disable debug mode for a vault
sgit dev debug
sgit dev debug off
Disable debug mode
sgit dev debug off [directory]
| Argument | | What it is |
|---|
directory | optional | Vault directory (default: .) |
sgit dev debug on
Enable debug mode
sgit dev debug on [directory]
| Argument | | What it is |
|---|
directory | optional | Vault directory (default: .) |
sgit dev debug status
Show current debug mode state
sgit dev debug status [directory]
| Argument | | What it is |
|---|
directory | optional | Vault directory (default: .) |
sgit dev derive-keys
Derive and display vault keys
sgit dev derive-keys <vault_key>
| Argument | | What it is |
|---|
vault_key | required | Vault key ({passphrase}:{vault_id}) |
sgit dev dump
Dump complete internal vault state as JSON
sgit dev dump [options] [directory]
| Argument | | What it is |
|---|
directory | optional | Vault directory (default: .) |
| Option | What it does |
|---|
--output, -o | Write dump JSON to FILE instead of stdout |
--remote | Dump remote server state instead of local |
--structure-key | Use structure key (hex) for metadata-only dump |
sgit dev plugins
Manage sgit-ai plugins
sgit dev plugins
sgit dev plugins disable
Disable a plugin
sgit dev plugins disable <name>
| Argument | | What it is |
|---|
name | required | Plugin name |
sgit dev plugins enable
Enable a plugin
sgit dev plugins enable <name>
| Argument | | What it is |
|---|
name | required | Plugin name |
sgit dev plugins list
List all plugins with status
sgit dev plugins list [options]
| Option | What it does |
|---|
--json | Output as JSON |
sgit dev plugins show
Show a plugin manifest
sgit dev plugins show <name>
| Argument | | What it is |
|---|
name | required | Plugin name |
sgit dev profile
Profile a vault operation
sgit dev profile
sgit dev profile clone
Profile the clone pipeline with per-phase timing
sgit dev profile clone [options] <vault_key> <directory>
| Argument | | What it is |
|---|
vault_key | required | Vault key ({passphrase}:{vault_id}) |
directory | required | Directory to clone into |
| Option | What it does |
|---|
--json | Output machine-readable JSON |
--output, -o | Write JSON to FILE instead of stdout |
--sparse | Sparse clone (no blob download) |
sgit dev replay
Replay / diff a clone trace JSON offline
sgit dev replay [options] <trace>
| Argument | | What it is |
|---|
trace | required | Path to trace JSON (from sgit dev profile clone --json) |
| Option | What it does |
|---|
--diff | Compare against a second trace JSON |
--json | JSON output |
sgit dev server-objects
Inventory remote objects by type
sgit dev server-objects [options] <vault_key>
| Argument | | What it is |
|---|
vault_key | required | Vault key |
| Option | What it does |
|---|
--json | JSON output |
--output, -o | Write JSON to FILE |
sgit dev step-clone
Pausable clone with per-phase progress
sgit dev step-clone [options] <vault_key> <directory>
| Argument | | What it is |
|---|
vault_key | required | Vault key |
directory | required | Directory to clone into |
| Option | What it does |
|---|
--json | JSON output |
--no-pause | Non-interactive; do not pause between steps |
sgit dev tree-graph
Visualise tree DAG from vault metadata
sgit dev tree-graph [options] <vault_key>
| Argument | | What it is |
|---|
vault_key | required | Vault key |
| Option | What it does |
|---|
--dot | Write Graphviz DOT to FILE |
--json | JSON output |
--output, -o | Write JSON to FILE |
sgit dev workflow
Workflow framework tools (sgit dev workflow <cmd>)
sgit dev workflow
sgit dev workflow gc
Clean up old workflow workspaces
sgit dev workflow gc [options]
| Option | What it does |
|---|
--older-than | Remove workspaces older than N days (default: 7) |
--vault-dir, -d | Vault directory (default: .) |
sgit dev workflow inspect
Inspect a workflow workspace by work-id
sgit dev workflow inspect [options] <work_id>
| Argument | | What it is |
|---|
work_id | required | Work ID (or prefix) |
| Option | What it does |
|---|
--vault-dir, -d | Vault directory (default: .) |
sgit dev workflow list
List registered workflows
sgit dev workflow list
sgit dev workflow log
Show recent transaction log records
sgit dev workflow log [options]
| Option | What it does |
|---|
--filter | Filter by workflow name |
--vault-dir, -d | Vault directory (default: .) |
sgit dev workflow resume
Resume an interrupted workflow
sgit dev workflow resume [options] <work_id>
| Argument | | What it is |
|---|
work_id | required | Work ID to resume |
| Option | What it does |
|---|
--vault-dir, -d | Vault directory (default: .) |
sgit dev workflow show
Show steps + I/O schemas for a workflow
sgit dev workflow show <workflow>
| Argument | | What it is |
|---|
workflow | required | Workflow name (e.g. clone) |
sgit dev workflow trace
Pretty-print the SGIT_TRACE=1 step trace log
sgit dev workflow trace [options] [vault_dir]
| Argument | | What it is |
|---|
vault_dir | optional | Vault directory (default: .) |
| Option | What it does |
|---|
--filter | Filter by workflow name |
This page as markdown · its source, admin/content/reference/sgit-cli-reference.json