numbors

numbors

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

Built for AI coding agents (Cursor, Cline, Windsurf, Codex, and more) and humans who live in the terminal.

Install

npm install -g numbors

Quick Start

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

# 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, [e-mail]"

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

Commands

Every workflow also has a direct command — handy for scripting and agents that prefer structured calls over natural language.

Command	What it does
numbors do "<text>"	Natural-language accounting — routes to the right action
numbors invoice	Create, list, and send invoices
numbors expense	Log and categorise expenses
numbors bank	Connect bank feeds, list accounts and transactions
numbors reconcile	Match bank transactions to the ledger
numbors contact	Manage the unified contact address book
numbors lead	CRM lead lifecycle — capture, qualify, convert
numbors tickets	Helpdesk tickets — create, list, reply, resolve
numbors actions	Review and approve queued agent actions
numbors stats	Snapshot of key business metrics
numbors status	Account and connection status
numbors audit	Recent activity / audit log
numbors health	Check API connectivity
numbors signup	Create a new company
numbors login	Save your API key
numbors key	Manage API keys

Run numbors --help (or numbors <command> --help) for the full reference.

Agent Integration

Add to your agent's rules file (.cursorrules, .clinerules, or your agent's AGENTS.md):

## 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.

License

Proprietary — © Tyga Cloud Ltd. See LICENSE.

Learn more at numbors.com.