cli.sgit.ai / Command reference / sgit file
sgit file
File operations (cat, ls, write).
Generated from sgit help all --format json, sgit-ai v0.23.0. 3 subcommands below. To change this page, change the command's register() in the CLI and regenerate.
sgit fileSubcommands
sgit file cat: Decrypt and print a vault file to stdoutsgit file ls: List vault files with fetch statussgit file write: Write a file directly to vault HEAD (agent/programmatic workflow)
sgit file cat
Decrypt and print a vault file to stdout
sgit file cat [options] <path> [directory]| Argument | What it is | |
|---|---|---|
path | required | File path inside the vault |
directory | optional | Vault directory (default: .) |
| Option | What it does |
|---|---|
--id | Print only the blob ID (zero network calls) |
--json | Print file metadata as JSON (path, blob_id, size, content_type, fetched) |
sgit file ls
List vault files with fetch status
sgit file ls [options] [path] [directory]| Argument | What it is | |
|---|---|---|
path | optional | Subdirectory or file path (default: root) |
directory | optional | Vault directory (default: .) |
| Option | What it does |
|---|---|
--ids | Include blob IDs in output |
--json | Output full entry metadata as JSON array |
sgit file write
Write a file directly to vault HEAD (agent/programmatic workflow)
sgit file write [options] <path> [directory]| Argument | What it is | |
|---|---|---|
path | required | Vault-relative file path to write |
directory | optional | Vault directory (default: .) |
| Option | What it does |
|---|---|
--also | Additional files to include atomically (repeatable) |
--file | Read content from LOCAL_FILE instead of stdin |
--json | Print result as JSON instead of plain text |
--message | Commit message (auto-generated if omitted) |
--push | Push immediately after writing; stdout contains only the blob ID |
This page as markdown · its source, admin/content/reference/sgit-cli-reference.json