Manifa

CLI reference

Every command below is generated straight from mani --help — the flags, arguments, and descriptions here can't drift out of sync with the binary you actually installed.

Manifa keeps your folders and .env files in sync across machines. File contents and filenames are end-to-end encrypted — the server stores only ciphertext and never holds your keys. It does see metadata (encrypted-blob sizes, file/chunk counts, sync timing, and device platform); see docs/threat-model.md for what is and isn't hidden.

Every command accepts the global options below in addition to its own.

Usage

mani [OPTIONS] <COMMAND>

Commands

  • login — Sign in to your Manifa account on this device
  • init — Set up your account on this device (creates your keys and recovery code)
  • logout — Sign out on this device (clears the local session; keeps this device enrolled)
  • vault — Create and list vaults
  • org — Manage your organization: invite people, accept invitations
  • account — Your account: sharing identity, etc
  • shares — List pending shares — invites waiting for the recipient to set up their keys
  • clone — Clone a vault into a directory on this machine
  • sync — Sync the current vault — push your changes, pull everyone else's
  • repair — Rebuild this vault's local state from the server when it's out of sync
  • status — Show your account, devices, and sync status
  • whoami — Show who you're signed in as and which organization is active
  • env — Sync encrypted .env files (push, pull, list)
  • daemon — Run and control the background sync daemon
  • watch — Continuously sync this folder until you stop it (Ctrl-C)
  • recovery — Manage your recovery code
  • device — Manage the devices on your account (enroll, list, revoke)
  • mount — Mount a vault as on-demand files: the whole tree is visible, file bytes hydrate the moment you open them (Phase 3 VFS; Linux, --features fuse)
  • schema — Print a machine-readable description of the whole CLI — every command, its parameters, read/write scope, and result shape, plus the error-code taxonomy. Built for agents and tooling: pipe mani --json schema to discover the surface instead of scraping --help
  • skill — Install and manage the Manifa agent skill in your coding-agent skill dirs
  • help — Print this message or the help of the given subcommand(s)

Options

mani --timing

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

mani --json

Emit a machine-readable result envelope instead of human text (works on every command). Success prints {"ok":true,"value":…}; failure prints {"ok":false,"error":{"code":…,"message":…}} with a differentiated exit code. Stable field names for scripting/agents

mani --quiet

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

mani --no-color

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

mani --help

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

mani --version

Print version (alias: -V)