Documentation
clovis
Local-first bookkeeping CLI
What it does
Local-first bookkeeping CLI
Usage
Usage: 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 commandSubcommands
toolsList every public app tooldoctor [options]Run local diagnosticstool [options] <name>Run any public app tool by nameaccountManage accountstxnManage transactionsbalance <account_id>Show posted balances for an accountinit [options]Initialize a ledger with default accountsexport [options]Export transactions as CSVimport [options]Import a CSV statement into an accountreportRun accounting reportshelp [command]display help for commandExamples
clovis init --currency CADclovis account balances --type assetclovis txn add --date 2026-06-01 --amount 100 --from <equity-id> --to <checking-id> --status postedclovis report balance-sheet --quote CADclovis tool account_balances --json '{"account_type":"asset"}'Notes
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.