CLI v0.1.0 — for AI agents

Your agent's
UK accounting team

Cards, bills, expenses, VAT and HMRC deadlines in one CLI. Structured JSON for agents, clean tables for humans, packaged workflows for both.

Install
curl -fsSL https://accounts-os.com/install.sh | bash
Or via npm
npm install -g @thriveventurelabs/accountsos

One CLI. Two output modes.

Run it in your terminal and you get a clean table. Pipe it anywhere or pass --json and you get structured data — ready to parse, no regex, no scraping.

Agent mode (--json or piped)
{"transactions":[
  {"id":"tx_1","date":"2026-04-15","amount":-89.00,
   "merchant_name":"AWS","category":"Software",
   "vat_amount":-14.83,"vat_rate":20},
  {"id":"tx_2","date":"2026-04-14","amount":-12.50,
   "merchant_name":"Anthropic","category":null,
   "vat_amount":null,"vat_rate":null}
],"count":2}

Stable schema. Categorical nulls explicit. Agent can branch oncategory === null without parsing.

Human mode (TTY)
Date        Description  Category       Amount
----------  -----------  -------------  --------
2026-04-15  AWS          Software       -£89.00
2026-04-14  Anthropic    uncategorized  -£12.50

2 transactions

Truncated columns, formatted GBP, dim styling for nulls. Built for skim-reading.

Auto-detected from isatty() — no flag needed in 90% of cases.

From zero to first transaction in 30 seconds

1

Install

curl -fsSL https://accounts-os.com/install.sh | bash

Or: npm install -g @thriveventurelabs/accountsos

2

Sign up

accountsos signup --email you@co.com --company "Acme Ltd"

Returns API key, saves to ~/.accountsos/config.json. Human gets a welcome email.

3

Use it

accountsos balance
accountsos vat
accountsos skills run receipt-compliance

Default: human-readable. Pipe or pass --json for agent mode.

Packaged agentic skills

Multi-step workflows. One command.

Common bookkeeping workflows packaged as named skills your agent can invoke directly. No prompt engineering required.

Receipt compliance

Find expense transactions over £30 missing a matched receipt. Flags compliance gaps before the VAT return.

accountsos skills run receipt-compliance

Transaction cleanup

Surface uncategorized transactions and AI-suggest categories. Run before month-end close.

accountsos skills run transaction-cleanup

VAT readiness

Check current VAT period: output, input, net due, blockers. Tells your agent if it's ready to file.

accountsos skills run vat-readiness

Deadline check

List all upcoming HMRC and Companies House deadlines with days remaining.

accountsos skills run deadline-check

Built for the way agents work

Stable JSON contracts

Every command returns predictable JSON in agent mode. No HTML scraping, no fragile regex against terminal output. Branch on field values, not line positions.

Auto-detects mode

Human-readable when run in a terminal, structured JSON when piped or called from an agent. No flag needed in 90% of cases.

Self-signup

Your agent can create an account on behalf of its human via accountsos signup. API key returned instantly. Welcome email is sent for the human to claim.

Same backend as MCP / A2A

CLI wraps /api/mcp. Same auth, same tools, same data as our MCP server (Claude Desktop) and /api/agent (A2A) endpoint. Pick the protocol that fits.

Scoped API keys

Read-only for monitoring, read+write for bookkeeping. Keys live in ~/.accountsos/config.json with 0600 perms or via ACCOUNTSOS_API_KEY env.

Packaged agentic skills

Receipt compliance, transaction cleanup, VAT readiness, deadline check. Multi-step workflows your agent can run as a single command.

Drop into any agent that can shell out

No SDK to install. The CLI is the integration. Use it from Claude Code, OpenAI agents, custom Python, n8n, anything that can spawn a subprocess.

Python
import subprocess, json

result = subprocess.run(
  ["accountsos", "vat", "--json"],
  capture_output=True, text=True
)
vat = json.loads(result.stdout)
print(f"Net VAT due: £{vat['vat_due']}")
Claude Code / shell tool
# Pipe forces JSON mode automatically
accountsos transactions list --limit 10 \
  | jq '.transactions[] | select(.category == null)'

# Run a packaged skill
accountsos skills run vat-readiness

Pick the protocol that fits

CLI, MCP server, A2A endpoint, REST. All hit the same backend.

CLI (new)
accountsos

For agents that shell out. Fastest install, dual output, packaged skills.

MCP server
accountsos-mcp

For Claude Desktop, Cline, MCP-aware tools. Native MCP protocol.

A2A endpoint
/api/agent

JSON-RPC 2.0, A2A protocol, AgentCard at .well-known/agent.json.

REST API
/api/mcp

Plain HTTP+JSON, Bearer auth. Build whatever fits.

Give your agent a finance team.

Free during Early Access. £9/month locked in for early adopters.

curl -fsSL https://accounts-os.com/install.sh | bash