CLI Reference
Sietch is designed with a CLI-first approach, providing a comprehensive command set for managing your encrypted vaults in any environment. This reference documents all available commands, their options, and practical examples.
Core Commands Overview
Vault Management
init, recover, verify, manifest - Commands for creating and maintaining vaults
File Operations
add, extract, decrypt, list - Commands for working with files in your vault
Sync & Discovery
sync, discover, peer - Commands for vault synchronization and peer management
Security
keys - Commands for encryption key management and security operations
Vault Management
sietch init
Creates a new encrypted vault with specified settings.
Bash
$sietch init --name spice-vault --encrypt aes256
Click to copy
Options:
| Option | Type | Default | Description |
|---|---|---|---|
--name | string | Name of the vault (user-friendly identifier) | |
--path | string | Current dir | Location to create the vault |
--key-type | string | aes | Encryption type: aes, gpg, or none |
--passphrase | flag | Prompt for passphrase to protect AES key | |
--chunking-strategy | string | fixed | Chunking strategy: fixed or cdc |
--chunk-size | string | 4MB | Size of chunks (e.g., 2MB) |
--compression | string | none | Compression: none, gzip, or zstd |
--hash | string | sha256 | Hash algorithm: sha256 or blake3 |
--interactive | flag | Use interactive prompt mode | |
--from-config | string | Initialize from existing config file |
Examples:
basic setup
sietch init --name desert-cache
Table of Contents