Manifa

mani vault

A vault is a synced root folder and its history — the unit of sharing and keying.

Usage

mani vault [OPTIONS] <COMMAND>

Commands

  • create — Create a vault from a directory and do the first sync
  • ls — List your vaults
  • rebind — Re-point this folder at a vault without re-downloading it
  • rm — Delete a vault (by name or id) and everything stored in it
  • help — Print this message or the help of the given subcommand(s)

Options

mani vault --timing

Print a per-phase timing breakdown to stderr (same as MANIFA_TIMING=1). Useful for diagnosing a slow sync / clone

mani vault --json

Output machine-readable JSON instead of the human table (for status, vault ls, device ls, env ls). Stable field names for scripting

mani vault --quiet

Suppress progress and chatter — print only results and errors (alias: -q)

mani vault --no-color

Never colorize output (also honored: the NO_COLOR env var). Color is off automatically when output isn't an interactive terminal

mani vault --help

Print help (alias: -h)

mani vault create

Create a vault from a directory and do the first sync

Usage

mani vault create [OPTIONS] <NAME> <PATH>

Arguments

  • <NAME> — A name for the vault
  • <PATH> — The directory to sync

Options

mani vault create --timing

Print a per-phase timing breakdown to stderr (same as MANIFA_TIMING=1). Useful for diagnosing a slow sync / clone

mani vault create --json

Output machine-readable JSON instead of the human table (for status, vault ls, device ls, env ls). Stable field names for scripting

mani vault create --quiet

Suppress progress and chatter — print only results and errors (alias: -q)

mani vault create --no-color

Never colorize output (also honored: the NO_COLOR env var). Color is off automatically when output isn't an interactive terminal

mani vault create --help

Print help (alias: -h)

mani vault ls

List your vaults

Usage

mani vault ls [OPTIONS]

Options

mani vault ls --timing

Print a per-phase timing breakdown to stderr (same as MANIFA_TIMING=1). Useful for diagnosing a slow sync / clone

mani vault ls --json

Output machine-readable JSON instead of the human table (for status, vault ls, device ls, env ls). Stable field names for scripting

mani vault ls --quiet

Suppress progress and chatter — print only results and errors (alias: -q)

mani vault ls --no-color

Never colorize output (also honored: the NO_COLOR env var). Color is off automatically when output isn't an interactive terminal

mani vault ls --help

Print help (alias: -h)

mani vault rebind

Re-point this folder at a vault without re-downloading it.

Use this when a folder's binding (the gitignored manifa.toml) was deleted and mani sync says "no vault binding" — e.g. you cleared the folder to stage new files and removed manifa.toml with them. Rebind rewrites the binding for the CURRENT directory and leaves your local files untouched, so you can then mani sync your changes up. Unlike clone --force, it never overwrites local files. Refuses if the folder is already bound to a different vault.

Usage

mani vault rebind [OPTIONS] <VAULT>

Arguments

  • <VAULT> — The vault this folder belongs to (name or id)

Options

mani vault rebind --timing

Print a per-phase timing breakdown to stderr (same as MANIFA_TIMING=1). Useful for diagnosing a slow sync / clone

mani vault rebind --json

Output machine-readable JSON instead of the human table (for status, vault ls, device ls, env ls). Stable field names for scripting

mani vault rebind --quiet

Suppress progress and chatter — print only results and errors (alias: -q)

mani vault rebind --no-color

Never colorize output (also honored: the NO_COLOR env var). Color is off automatically when output isn't an interactive terminal

mani vault rebind --help

Print help (see a summary with '-h') (alias: -h)

mani vault rm

Delete a vault (by name or id) and everything stored in it

Usage

mani vault rm [OPTIONS] <VAULT>

Arguments

  • <VAULT> — The vault to delete — its name or id

Options

mani vault rm --timing

Print a per-phase timing breakdown to stderr (same as MANIFA_TIMING=1). Useful for diagnosing a slow sync / clone

mani vault rm --yes

Skip the confirmation prompt (required when not running interactively) (alias: -y)

mani vault rm --json

Output machine-readable JSON instead of the human table (for status, vault ls, device ls, env ls). Stable field names for scripting

mani vault rm --quiet

Suppress progress and chatter — print only results and errors (alias: -q)

mani vault rm --no-color

Never colorize output (also honored: the NO_COLOR env var). Color is off automatically when output isn't an interactive terminal

mani vault rm --help

Print help (alias: -h)