Billing from your terminal
Create invoices, manage expenses, record payments, and generate reports, all from the command line. Perfect for automation, scripting, and AI-powered workflows.
$ curl -fsSL https://billingnow.com/cli/install.sh | bashInstallation
Run the installer
The installer downloads the CLI and sets up everything automatically.
$ curl -fsSL https://billingnow.com/cli/install.sh | bashAdd to PATH (if prompted)
If the installer shows a PATH warning, add this line to your shell profile:
export PATH="$HOME/.local/bin:$PATH"Authenticate
Log in to connect the CLI to your BillingNow account. This opens your browser for secure OAuth authentication.
$ bn loginVerify installation
Check that everything is working by viewing your current user:
$ bn whoamiRequirements
- Node.js 18 or higher
- macOS or Linux (Windows via WSL)
- curl or wget
- BillingNow account
Alternative: API Key Login
For CI/CD or headless environments, authenticate with an API key:
$ bn login --key YOUR_API_KEYCommand Reference
Complete list of available commands. All commands support --format json for machine-readable output.
Invoices
bn invoice listList all invoicesbn invoice list --status sentFilter by statusbn invoice get <id>Get invoice detailsbn invoice create --relation <id> --items '[{...}]'Create invoicebn invoice status <id> sentChange statusbn invoice delete <id>Delete invoice
Expenses
bn expense listList all expensesbn expense create --relation <id> --total 500Create expensebn expense analyze <id>Check AI analysis statusbn expense confirm <id>Confirm extracted data
Payments
bn payment listList all paymentsbn payment create --invoice <id> --amount 500Record invoice paymentbn payment update <id> --amount 550Update a paymentbn payment delete <id>Delete a payment
Clients & Suppliers
bn relation list --type clientList clientsbn relation create --name "Acme Inc" --currency USDCreate relationbn relation update <id> --email new@email.comUpdate relation
Reporting
bn reporting activity --period this-monthActivity reportbn reporting sales --period this-yearSales summarybn reporting tax --years 2024,2025 --display-by quarterlyTax report
AI Skills
bn skill installInstall skill for AI agentsbn skill statusCheck installed version vs CLIbn skill updateUpdate to current CLI version
AI Agent Integration
Use the BillingNow CLI skill with Claude Code or any AI agent that supports custom skills. Let AI manage your invoices through natural language.
Natural Language
Ask AI to create invoices, check payment status, or generate reports in plain English.
Automatic Execution
AI translates your requests into CLI commands and executes them automatically.
Smart Context
The skill provides command documentation so AI knows exactly how to help.
- Create an invoice for Acme Inc for 10 hours of consulting at $150/hour
- Show me all unpaid invoices from this month
- Record a $500 payment for invoice INV-042
- Generate a sales report for Q4 2024
Everything you need to know
Can't find the answer you're looking for? Reach out to our team →
Not really. The install is one command, login is one command, and from there you can drive everything from natural-language prompts via Claude Code or any AI agent. The CLI is also there if you want raw control.
In ~/.billingnow/config.json on your machine. The token is scoped to your account and you can revoke it from your dashboard at any time.
Yes. Use bn login --key <api-key> with a key you generate from Settings → API keys. It's the recommended path for CI/CD and headless servers.
Every list / get / create / update command. Combine it with jq and you can pipe BillingNow data into anything.
Install now and invoice faster
Get the CLI running in under a minute. No configuration required.