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 [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

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.