Documentation

clovis

Local-first bookkeeping CLI

npm

What it does

Local-first bookkeeping CLI

UsageUsage: clovis [options] [command]

Options

--format <format>Output format: json or table
--db <path>Path to ledger database (default: "./ledger.db")
-V, --versionoutput the version number
-h, --helpdisplay help for command

Subcommands

toolsList every public app tool
txnManage transactions
help [command]display help for command

Examples

clovis init --currency CAD
clovis account balances --type asset
clovis txn add --date 2026-06-01 --amount 100 --from <equity-id> --to <checking-id> --status posted
clovis report balance-sheet --quote CAD
clovis tool account_balances --json '{"account_type":"asset"}'

Notes

Default ledger: /home/clovis/.clovis/clovis.db
Use --db or CLOVIS_DB to select another ledger.
Use --format json for stable machine-readable output.
Clovis does not infer report currency; report commands require --quote.

Raw help output

This is the exact help text captured from the published package.

Usage: clovis [options] [command]

Local-first bookkeeping CLI

Options:
  --format <format>      Output format: json or table
  --db <path>            Path to ledger database (default: "./ledger.db")
  -V, --version          output the version number
  -h, --help             display help for command

Commands:
  tools                  List every public app tool
  doctor [options]       Run local diagnostics
  tool [options] <name>  Run any public app tool by name
  account                Manage accounts
  txn                    Manage transactions
  balance <account_id>   Show posted balances for an account
  init [options]         Initialize a ledger with default accounts
  export [options]       Export transactions as CSV
  import [options]       Import a CSV statement into an account
  report                 Run accounting reports
  help [command]         display help for command

Examples:
  clovis init --currency CAD
  clovis account balances --type asset
  clovis txn add --date 2026-06-01 --amount 100 --from <equity-id> --to <checking-id> --status posted
  clovis report balance-sheet --quote CAD
  clovis tool account_balances --json '{"account_type":"asset"}'

Notes:
  Default ledger: /home/clovis/.clovis/clovis.db
  Use --db or CLOVIS_DB to select another ledger.
  Use --format json for stable machine-readable output.
  Clovis does not infer report currency; report commands require --quote.