numbors

Agent-first accounting CLI. Create invoices, reconcile banks, manage expenses — as easy as talking.

Install

npm install -g numbors

Quick Start

# 1. Sign up
numbors signup my-company --email [email protected]

# 2. Human pays £1 to activate (link shown after signup)

# 3. Save your API key
numbors login --key nb_xxx --local

# 4. Start using
numbors do "Invoice Acme for 10 hours consulting at £150/hr"
numbors do "Log £45 lunch at Pret, client meeting"
numbors do "Reconcile current account for May"
numbors do "Add customer Sarah Chen, [email protected]"

The do Command

The killer feature. Plain English accounting:

numbors do "Invoice Acme for 10 hours at £150/hr"     # → Draft invoice created
numbors do "Log £45 lunch at Pret"                      # → Expense recorded
numbors do "Reconcile current account for May"          # → 47 matched, 3 need review
numbors do "Add customer Sarah Chen"                    # → Contact created
numbors do "Run month-end close for May"                # → Queued for approval
numbors do "Prepare VAT return for Q1"                  # → Preview ready

Agent Integration

Add to your project's CLAUDE.md, .cursorrules, or .clinerules:

## Numbors
Use the `numbors` CLI for accounting operations.
Key is in .numbors/config.json (auto-loaded).
Run `numbors --help` for reference.
Quick: `numbors do "Create invoice for ClientName, 10 hours at £150/hr"`

Per-Project Config

numbors login --local --key nb_xxx   # saves to .numbors/config.json

Add .numbors/ to your .gitignore.

All Commands

Run numbors --help for the full reference.

License

MIT