CLI Reference
The bitpilot CLI is installed via pip install bitpilot.
Global Options
| Option | Default | Description |
|---|---|---|
--network | testnet | mainnet, testnet, or signet |
--wallet-path | ~/.bitpilot/wallet.dat | Encrypted wallet file path |
--version | Show version and exit |
Mainnet usage requires interactive confirmation.
Commands
init-wallet
Create a new HD wallet with a BIP-39 mnemonic.
bitpilot init-wallet [--word-count 12|15|18|21|24]
Prompts for an encryption passphrase. Displays the mnemonic once.
balance
Show the current wallet balance.
bitpilot balance [--json-output]
sync
Refresh UTXOs from the network backend.
bitpilot sync [--json-output]
utxos
List unspent transaction outputs.
bitpilot utxos [--json-output] [--confirmed-only]
fees
Show current fee estimates from mempool.space.
bitpilot fees [--json-output]
propose
Create a payment proposal (does not send funds).
bitpilot propose --to <address> --amount-sats <n> [--fee-rate <sat/vB>] [--memo <text>] [--json-output]
If --fee-rate is omitted, the medium-priority rate is auto-fetched.
approve
Approve a proposal and broadcast the transaction.
bitpilot approve --proposal-id <id> [--json-output]
reject
Reject and discard a proposal.
bitpilot reject --proposal-id <id>
proposals
List all proposals in the current session.
bitpilot proposals [--json-output]
audit
Show recent entries from the audit ledger.
bitpilot audit [--last 20] [--json-output] [--audit-path ~/.bitpilot/audit.jsonl]
status
Show wallet runtime status (network, backend, sync state).
bitpilot status
report
Generate a spend report from the audit ledger.
bitpilot report [--since 30d] [--format table|csv|json] [--btc-price <usd>] [--audit-path ~/.bitpilot/audit.jsonl]