CLI Tool

The Hisaabo CLI (hisaabo) brings your entire business management workflow to the terminal. Built with Ink 5 (React for the terminal) and Commander.js, it renders rich interactive tables, colored status badges, and INR-formatted numbers directly in your shell.

It is useful for three things: quick lookups without opening a browser, automation scripts and cron jobs, and AI agent workflows that execute shell commands as part of a broader pipeline.

By default, commands render a pretty table with color. Pass --json to get clean JSON output for piping into jq or other tools.

Installation

npm install -g @hisaabo/cli

Or use without installing:

npx @hisaabo/cli <command>

Verify the installation:

hisaabo --version

Authentication

hisaabo login --api-url https://your-hisaabo-instance.com

Your browser opens so you can sign in to the Hisaabo web app (magic link). The CLI listens on a temporary 127.0.0.1 port, receives a one-time code there, and exchanges it using PKCE, so no password or long-lived secret is typed into the terminal. If the browser does not open (for example over SSH), copy the printed URL into a browser on any machine that can reach the web app; the sign-in must complete on the same machine unless the callback port is forwarded.

If you have more than one business you are asked to pick one; change it later with hisaabo switch.

Option	Description
`--api-url <url>`	Server URL (env: `HISAABO_API_URL`). Prompted for if omitted
`--web-url <url>`	Web app URL used for browser sign-in (env: `HISAABO_WEB_URL`). Needed on self-hosted servers whose web app is not at the default hosted address
`--token-stdin`	Read an API key from stdin instead of using the browser (requires `--api-url`)

There is no email/password prompt. The CLI sends X-Hisaabo-Client: cli and receives a session token that is stored in the config file.

Create an API key in the Hisaabo web app under Settings → API Keys (admins only, paid plans), or with hisaabo api-key create once you are signed in, then pipe it in:

echo "hisaabo_key_xxxxxxxxxxxxxxxxxx" | hisaabo login --api-url https://your-instance.com --token-stdin

The CLI validates the key, resolves your user and business, and stores it in the config file. Avoid the deprecated --token <key> flag: the key would be visible in the process list and your shell history.

API keys expire (default 90 days, maximum 365 days; set it with hisaabo api-key create --expires-in-days) and are revoked when the member is removed or their role changes.

Environment variables (recommended for automation)

For cron jobs and CI/CD pipelines, set credentials as environment variables instead of logging in. Nothing is written to disk:

export HISAABO_API_URL=https://your-hisaabo-instance.com
export HISAABO_TOKEN=hisaabo_key_xxxxxxxxxxxxxxxxxx
export HISAABO_TENANT_ID=your-tenant-uuid
export HISAABO_BUSINESS_ID=your-business-uuid

HISAABO_TOKEN is used only when HISAABO_API_URL is also set.

Transport security

The API URL must use https://. Plain http:// is accepted only for loopback hosts (localhost, 127.0.0.0/8, ::1); for anything else the CLI refuses to send credentials unless you set HISAABO_ALLOW_INSECURE=1. URLs that contain user:password@ are rejected.

Listing and switching businesses

# List all businesses on your account
hisaabo business list

# Switch the active business (interactive picker)
hisaabo switch

Set the next document number with business sequence (it can only move forward):

hisaabo business sequence --type invoice --next-number 101

--type is one of invoice, payment, quotation, credit_note, delivery_challan, proforma.

Switching updates the stored businessId in the config file. All subsequent commands operate on the newly selected business. Create new businesses in the web or mobile app.

Web app: Tap the business name in the sidebar to open a popover that lists all your businesses and includes a “Create New Business” option. Selecting a business reloads all data for that context.

Mobile app: Tap the business name on the home dashboard to open a bottom sheet with the same business list and create option.

Profile and sign-out

There is no CLI command to register an account; accounts are created in the web app (or by accepting an invitation).

# Update your display name
hisaabo profile update-name "New Name"

# Sign out of this device
hisaabo logout

# Sign out of all devices (useful after a credential change)
hisaabo logout --all

Command Reference

`hisaabo dashboard`

Display key business metrics.

hisaabo dashboard
hisaabo dashboard --period today
hisaabo dashboard --period this-week
hisaabo dashboard --period this-month
hisaabo dashboard --period last-month
hisaabo dashboard --period this-year
hisaabo dashboard --from 2026-01-01 --to 2026-03-31

Flag	Description
`--period`	`today`, `this-week`, `this-month`, `last-month`, `this-year`
`--from` / `--to`	Custom date range (ISO 8601)
`--json`	Raw JSON output

Example output:

Business Dashboard — March 2026
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Revenue:        ₹4,82,500
Expenses:       ₹1,23,400
Net Profit:     ₹3,59,100
Outstanding:    ₹78,250 (6 overdue invoices)

Top customers this month:
  Gupta Enterprises      ₹1,42,000
  Sharma Traders         ₹98,500
  Vinod & Sons           ₹67,000

Low stock alerts: 3 items

`hisaabo invoice`

`hisaabo invoice list`

hisaabo invoice list
hisaabo invoice list --status overdue
hisaabo invoice list --status paid
hisaabo invoice list --party "Sharma Traders"
hisaabo invoice list --from 2026-03-01 --to 2026-03-31
hisaabo invoice list --status overdue --sort oldest-first
hisaabo invoice list --type purchase
hisaabo invoice list --json

Flag	Description
`--status`	`draft`, `sent`, `paid`, `overdue`, `cancelled`
`--type`	`sale` (default) or `purchase`
`--party`	Party name or ID
`--from` / `--to`	Date range
`--sort`	`newest-first` (default), `oldest-first`, `amount-asc`, `amount-desc`
`--limit`	Max results (default 50, max 100)
`--json`	Raw JSON output

`hisaabo invoice get`

hisaabo invoice get BB-12948
hisaabo invoice get inv_xxxxxxxxxx --json

`hisaabo invoice create`

Interactive wizard when run without flags. Or pass flags for scripting:

hisaabo invoice create \
  --party "Montu Arora" \
  --item "Spinach" --quantity 7.3 --unit kg --price 65 \
  --item "Tomato" --quantity 5 --unit kg --price 40 \
  --date 2026-03-26 \
  --due-date 2026-04-10

For complex invoices with many line items, pass a JSON file:

hisaabo invoice create --from-file invoice.json

Where invoice.json follows the format:

{
  "party": "Gupta Enterprises",
  "date": "2026-03-26",
  "dueDate": "2026-04-10",
  "items": [
    { "item": "Basmati Rice 25kg", "quantity": 10, "unit": "bag", "price": "1250.00" },
    { "item": "Mustard Oil 15L", "quantity": 5, "unit": "can", "price": "2100.00" }
  ],
  "notes": "Delivery to warehouse on 28th"
}

`hisaabo invoice pdf`

# Download PDF to current directory
hisaabo invoice pdf BB-12948

# Specify output path
hisaabo invoice pdf BB-12948 --output /tmp/invoices/

# Thermal (58mm) format
hisaabo invoice pdf BB-12948 --format thermal

`hisaabo invoice update`

Update fields on an existing invoice. Only draft invoices can be fully edited; sent or paid invoices accept a limited set of changes.

hisaabo invoice update BB-12948 \
  --notes "Updated payment terms: 30 days net" \
  --due-date 2026-04-30

Pass --from-file invoice.json to replace the full invoice body from a JSON file (same format as invoice create).

`hisaabo invoice delete`

hisaabo invoice delete BB-12948

Only draft invoices can be deleted. Sent or paid invoices must be cancelled via status update.

`hisaabo party`

`hisaabo party list`

hisaabo party list
hisaabo party list --type customer
hisaabo party list --type supplier
hisaabo party list --search "sharma"
hisaabo party list --outstanding   # only parties with unpaid balance
hisaabo party list --json

`hisaabo party get`

hisaabo party get "Sharma Traders"
hisaabo party get party_xxxxxxxxxx --ledger
hisaabo party get "Gupta Enterprises" --ledger --from 2026-01-01

`hisaabo party create`

hisaabo party create \
  --name "Mehta & Sons" \
  --type customer \
  --phone 9876543210 \
  --gstin 27AABCU9603R1ZX \
  --city Mumbai \
  --state Maharashtra

`hisaabo party ledger-report`

Full ledger report with opening balance, all transactions, and closing balance for a date range:

hisaabo party ledger-report --party "Gupta Enterprises" --from 2026-04-01 --to 2026-03-31
hisaabo party ledger-report --party party_xxxxxxxxxx --json

`hisaabo party stats`

Aggregate transaction statistics (total sales, purchases, payments) for a party:

hisaabo party stats party_xxxxxxxxxx
hisaabo party stats "Sharma Traders" --json

`hisaabo party top-items`

Items most frequently bought from or sold to a party, ranked by quantity or value:

hisaabo party top-items party_xxxxxxxxxx
hisaabo party top-items "Gupta Enterprises" --limit 10 --json

`hisaabo party merge`

Merge two duplicate party records. All invoices, payments, and ledger entries are reassigned to the target party and the source is deleted.

hisaabo party merge --source party_xxxxxxxxxx --target party_yyyyyyyyyy

`hisaabo party delete`

hisaabo party delete party_xxxxxxxxxx

Fails if the party has any invoices or payments on record.

`hisaabo item`

`hisaabo item list`

hisaabo item list
hisaabo item list --low-stock
hisaabo item list --search "rice"
hisaabo item list --category "Grains"
hisaabo item list --json

`hisaabo item get`

hisaabo item get "Basmati Rice 25kg"
hisaabo item get item_xxxxxxxxxx --json

`hisaabo item create`

hisaabo item create \
  --name "Mustard Oil 15L" \
  --unit can \
  --price 2100 \
  --hsn 1514 \
  --gst 5 \
  --category "Oils & Ghee" \
  --opening-stock 20 \
  --low-stock-threshold 5

`hisaabo item delete`

hisaabo item delete item_xxxxxxxxxx

Fails if the item appears on any invoice.

`hisaabo item stock`

Adjust stock quantity:

# Add stock (positive adjustment)
hisaabo item stock "Basmati Rice 25kg" --adjustment +50 --reason "Purchase from supplier"

# Remove stock (negative adjustment)
hisaabo item stock "Mustard Oil 15L" --adjustment -3 --reason "Damaged in transit"

`hisaabo item stock-history`

Full log of every stock adjustment ever made on an item:

hisaabo item stock-history "Basmati Rice 25kg"
hisaabo item stock-history item_xxxxxxxxxx --from 2026-01-01 --json

`hisaabo item stock-movements`

Every stock movement including invoice deductions, purchase additions, and manual adjustments:

hisaabo item stock-movements "Mustard Oil 15L"
hisaabo item stock-movements item_xxxxxxxxxx --period 6m --limit 100 --json

`hisaabo item stock-summary`

Total stock in, total out and net change over a whole period (--period 6m|1y|all), optionally in an alt unit:

hisaabo item stock-summary "Mustard Oil 15L" --period 1y
hisaabo item stock-summary item_xxxxxxxxxx --unit box --json

`hisaabo item low-stock-count`

Quick count of items currently at or below their low-stock threshold:

hisaabo item low-stock-count

`hisaabo item price-history`

Historical sale price changes for an item:

hisaabo item price-history "Basmati Rice 25kg"
hisaabo item price-history item_xxxxxxxxxx --period 6m --limit 100 --json

`hisaabo item price-summary`

Min, max, average and latest price over a whole period. --type sale|purchase picks the series; --unit normalises to a display unit:

hisaabo item price-summary "Basmati Rice 25kg" --period 1y
hisaabo item price-summary item_xxxxxxxxxx --type purchase --json

`hisaabo item sales-stats`

Total units sold and revenue for an item over a period:

hisaabo item sales-stats "Basmati Rice 25kg" --from 2026-04-01 --to 2026-03-31
hisaabo item sales-stats item_xxxxxxxxxx --json

`hisaabo item variants`

Manage variants (size, grade, colour, etc.) for an item that has multiple options at different prices or units.

# List variants
hisaabo item variants list item_xxxxxxxxxx

# Add a variant
hisaabo item variants create \
  --item item_xxxxxxxxxx \
  --name "500g Pack" \
  --price 120 \
  --unit pack

# Update a variant
hisaabo item variants update variant_xxxxxxxxxx --price 130

# Delete a variant
hisaabo item variants delete variant_xxxxxxxxxx

`hisaabo item merge`

Merge two duplicate item records. All line items and stock history are reassigned to the target and the source is deleted.

hisaabo item merge --source item_xxxxxxxxxx --target item_yyyyyyyyyy

`hisaabo item switch-base-unit`

Change the base unit of measurement for an item (e.g. kg to g). Provide the conversion factor.

hisaabo item switch-base-unit item_xxxxxxxxxx --new-unit g --factor 1000

`hisaabo item rename-unit`

Rename a unit on an item without changing any quantities (e.g. rename pcs to pieces):

hisaabo item rename-unit item_xxxxxxxxxx --from pcs --to pieces

`hisaabo payment`

`hisaabo payment list`

hisaabo payment list
hisaabo payment list --party "Sharma Traders"
hisaabo payment list --from 2026-03-01 --to 2026-03-31
hisaabo payment list --mode upi
hisaabo payment list --json

`hisaabo payment create`

# Payment received from customer
hisaabo payment create \
  --party "Sharma Traders" \
  --amount 25000 \
  --mode upi \
  --date 2026-03-26 \
  --reference "UTR123456789" \
  --allocate BB-12800 BB-12801

# Bulk payment (no specific invoice allocation)
hisaabo payment create \
  --party "Gupta Enterprises" \
  --amount 50000 \
  --mode bank \
  --reference "NEFT20260326"

`hisaabo payment delete`

hisaabo payment delete pay_xxxxxxxxxx

`hisaabo payment unpaid-invoices`

List invoices that still have an outstanding balance — useful before recording a payment to see what to allocate:

hisaabo payment unpaid-invoices
hisaabo payment unpaid-invoices --party "Sharma Traders" --json

`hisaabo payment untracked`

Payments that were recorded but have not been linked to any invoice:

hisaabo payment untracked
hisaabo payment untracked --json

`hisaabo payment default-account`

Show the bank account that is currently set as the default for incoming payments:

hisaabo payment default-account

`hisaabo payment assign-account`

Assign a bank account to an existing payment record:

hisaabo payment assign-account --payment pay_xxxxxxxxxx --account account_xxxxxxxxxx

`hisaabo expense`

`hisaabo expense list`

hisaabo expense list
hisaabo expense list --category "Transport"
hisaabo expense list --from 2026-03-01 --to 2026-03-31
hisaabo expense list --json

`hisaabo expense create`

hisaabo expense create \
  --amount 1500 \
  --category "Transport" \
  --date 2026-03-26 \
  --description "Delivery to Sector 15 warehouse"

`hisaabo expense delete`

hisaabo expense delete exp_xxxxxxxxxx

`hisaabo gst`

`hisaabo gst r1`

Get GSTR-1 data (outward supplies):

hisaabo gst r1 --month 3 --year 2026
hisaabo gst r1 --month 3 --year 2026 --json
hisaabo gst r1 --month 3 --year 2026 --csv --output /var/gst-reports/

`hisaabo gst r3b`

Get GSTR-3B summary (monthly return):

hisaabo gst r3b --month 3 --year 2026
hisaabo gst r3b --month 3 --year 2026 --csv --output /var/gst-reports/

`hisaabo automated-invoice`

Manage recurring invoice templates that auto-generate invoices on a schedule.

`hisaabo automated-invoice list`

hisaabo automated-invoice list [--status active|paused|completed|expired] [--json]

Lists all recurring invoice templates with name, party, frequency, status, next run date, and run count.

`hisaabo automated-invoice get`

hisaabo automated-invoice get <template-id> [--json]

Shows full template details including line items and execution history.

`hisaabo automated-invoice create`

hisaabo automated-invoice create \
  --name "Monthly Rent to Gupta Ji" \
  --party-id <uuid> \
  --type sale \
  --frequency monthly \
  --start-date 2026-04-01T00:00:00Z \
  --line-items '[{"description":"Office Rent","quantity":"1","unitPrice":"25000.00","taxPercent":"18"}]' \
  [--end-date 2027-03-31T00:00:00Z] \
  [--max-runs 12] \
  [--notes "Annual rent agreement"] \
  [--json]

`hisaabo automated-invoice pause`

hisaabo automated-invoice pause <template-id> [--json]

Pauses an active template. No invoices will be generated until resumed.

`hisaabo automated-invoice resume`

hisaabo automated-invoice resume <template-id> [--json]

Resumes a paused template. Next run date is recalculated from now.

`hisaabo automated-invoice run-now`

hisaabo automated-invoice run-now <template-id> [--json]

Manually trigger immediate invoice generation from a template.

`hisaabo automated-invoice delete`

hisaabo automated-invoice delete <template-id> [-y] [--json]

Permanently deletes a template and all its execution history.

`hisaabo shipment`

`hisaabo shipment list`

hisaabo shipment list
hisaabo shipment list --status in_transit
hisaabo shipment list --from 2026-03-01 --json

`hisaabo shipment get`

hisaabo shipment get ship_xxxxxxxxxx

Shows full tracking event history.

`hisaabo shipment create`

hisaabo shipment create \
  --invoice BB-14821 \
  --mode "Delhivery" \
  --tracking "DEL9876543210" \
  --dispatch-date 2026-03-27

`hisaabo shipment update`

hisaabo shipment update ship_xxxxxxxxxx \
  --status delivered \
  --notes "Delivered to reception, signed by Ramesh"

`hisaabo bank`

`hisaabo bank list`

hisaabo bank list
hisaabo bank list --json

Shows all bank accounts and cash accounts with current balances.

`hisaabo bank get`

hisaabo bank get account_xxxxxxxxxx
hisaabo bank get "SBI Current" --transactions --from 2026-03-01

`hisaabo bank create`

hisaabo bank create \
  --name "HDFC Current Account" \
  --type bank \
  --account-number "1234567890" \
  --ifsc "HDFC0001234" \
  --opening-balance 50000

`hisaabo bank transfer`

hisaabo bank transfer \
  --from "SBI Current" \
  --to "Petty Cash" \
  --amount 5000 \
  --date 2026-03-26 \
  --notes "Weekly petty cash replenishment"

`hisaabo bank transactions`

hisaabo bank transactions "HDFC Current Account"
hisaabo bank transactions account_xxxxxxxxxx --from 2026-03-01 --to 2026-03-31 --json

`hisaabo bank gateway-config`

View the gateway configuration (charge rates, settlement account) for a payment gateway account.

hisaabo bank gateway-config <accountId>
hisaabo bank gateway-config <accountId> --json

`hisaabo bank update-gateway`

Update gateway charge rates or settlement account.

hisaabo bank update-gateway <accountId> --charge-credit-card 2.5 --charge-upi 0
hisaabo bank update-gateway <accountId> --settlement-account <bankAccountId>

Charge values are percentages by default. Use flat:20 for a flat ₹20 charge.

`hisaabo report`

`hisaabo report daybook`

All transactions for a date range, ordered by date:

hisaabo report daybook --from 2026-03-01 --to 2026-03-31
hisaabo report daybook --from 2026-03-26 --to 2026-03-26 --json

`hisaabo report outstanding`

Receivables and payables with aging buckets:

hisaabo report outstanding
hisaabo report outstanding --type receivable
hisaabo report outstanding --json

`hisaabo report tax-summary`

Taxable turnover and GST by rate for a period:

hisaabo report tax-summary --from 2026-01-01 --to 2026-03-31
hisaabo report tax-summary --from 2026-04-01 --to 2026-03-31 --json

`hisaabo report item-sales`

Top items by sales quantity and revenue:

hisaabo report item-sales --period this-month
hisaabo report item-sales --from 2026-04-01 --to 2026-03-31 --json

`hisaabo report stock`

Current stock value and opening/closing comparison:

hisaabo report stock
hisaabo report stock --json

`hisaabo target`

`hisaabo target list`

hisaabo target list
hisaabo target list --period monthly --json

`hisaabo target create`

hisaabo target create \
  --name "Q1 Revenue Target" \
  --type order_value \
  --value 500000 \
  --period monthly

`hisaabo target my`

Show targets assigned to you (useful for sales team members):

hisaabo target my
hisaabo target my --json

`hisaabo import`

`hisaabo import parties`

# From CSV
hisaabo import parties parties.csv --format csv

# From JSON
hisaabo import parties parties.json --format json

# From a MyBillBook export
hisaabo import parties parties.csv --source mybillbook

All import commands take the file as a positional argument and accept --source <source> to choose the adapter. The default is hisaabo (Hisaabo’s own CSV/JSON layout); use --source mybillbook for MyBillBook exports.

`hisaabo import items`

hisaabo import items catalog.csv --format csv
hisaabo import items catalog.json

`hisaabo export`

Download a full tenant backup as a .tar.gz archive. This is a tenant-level operation — it does not require a business to be selected.

# Export by tenant slug
hisaabo export --tenant my-company -o backup.tar.gz

# Export by tenant UUID
hisaabo export --tenant 550e8400-e29b-41d4-a716-446655440000 -o /tmp/backup.tar.gz

Flag	Description
`--tenant`	Tenant slug or UUID to export (required)
`-o, --output`	Output file path (required)

On success, prints the file size, SHA256 hash, and download time.

Exit code	Meaning
0	Success
1	Not authenticated or insufficient permissions
2	Rate limit reached (max 2 exports per day)
5	Server or network error

`hisaabo restore`

Upload a .tar.gz backup archive into an empty tenant. The target tenant must have zero businesses.

# Restore by tenant slug (interactive confirmation)
hisaabo restore --tenant my-company -i backup.tar.gz

# Skip confirmation prompt
hisaabo restore --tenant my-company -i backup.tar.gz --yes

# Restore by tenant UUID
hisaabo restore --tenant 550e8400-e29b-41d4-a716-446655440000 -i backup.tar.gz -y

Flag	Description
`--tenant`	Target tenant slug or UUID — must be empty (required)
`-i, --input`	Input backup file path (required)
`-y, --yes`	Skip confirmation prompt

On success, prints rows inserted per table, skipped rows, warnings, and upload time.

Exit code	Meaning
0	Success
1	Not authenticated or insufficient permissions
3	Target tenant is not empty
4	Input file missing, unreadable, or empty
5	Server or network error

`hisaabo store`

`hisaabo store settings`

hisaabo store settings
hisaabo store settings --json

`hisaabo store orders`

hisaabo store orders
hisaabo store orders --status pending
hisaabo store orders --from 2026-03-01 --json

`hisaabo store order confirm`

Mark a pending store order as confirmed and begin fulfillment:

hisaabo store order confirm order_xxxxxxxxxx

`hisaabo store order cancel`

Cancel a store order:

hisaabo store order cancel order_xxxxxxxxxx --reason "Out of stock"

`hisaabo store check-slug`

Check whether a URL slug is available before updating your store URL:

hisaabo store check-slug my-store-name

`hisaabo store items`

List items currently shown in your online store:

hisaabo store items
hisaabo store items --json

`hisaabo store items toggle`

Bulk enable or disable items in the store without editing each one individually:

# Enable multiple items
hisaabo store items toggle --enable item_aaa item_bbb item_ccc

# Disable multiple items
hisaabo store items toggle --disable item_ddd item_eee

`hisaabo tenant`

Manage the tenant (organisation) that owns your businesses. Most users operate within a single tenant and never need these commands. They are most relevant to agency operators who manage multiple tenants.

`hisaabo tenant list`

hisaabo tenant list
hisaabo tenant list --json

`hisaabo tenant select`

Switch the active tenant. All subsequent commands operate in the context of the selected tenant.

hisaabo tenant select tenant_xxxxxxxxxx

`hisaabo tenant members`

List members of the current tenant:

hisaabo tenant members
hisaabo tenant members --json

`hisaabo tenant invite`

Invite a new member by email. The invitation is emailed to them; the CLI does not print an invite link.

hisaabo tenant invite [email protected] --role seller

Available roles: admin, seller_manager, seller (default), accountant.

`hisaabo tenant remove`

Remove a member from the tenant:

hisaabo tenant remove user_xxxxxxxxxx --yes

`hisaabo tenant update-role`

Update a member’s role:

hisaabo tenant update-role user_xxxxxxxxxx admin

`hisaabo tenant invitations`

List pending invitations for the current tenant.

hisaabo tenant invitations
hisaabo tenant invitations --json

`hisaabo tenant revoke-invitation`

Revoke a pending invitation.

hisaabo tenant revoke-invitation <invitationId>

Document types

Beyond standard invoices, Hisaabo supports six additional document types. Each type has the same five operations: list, get, create, status, and delete.

Quotation

hisaabo quotation list
hisaabo quotation list --party "Gupta Enterprises" --json
hisaabo quotation get quot_xxxxxxxxxx
hisaabo quotation create \
  --party "Mehta & Sons" \
  --item "Basmati Rice 25kg" --quantity 50 --unit bag --price 1250 \
  --valid-until 2026-04-30
hisaabo quotation status quot_xxxxxxxxxx accepted
hisaabo quotation delete quot_xxxxxxxxxx

Credit Note

hisaabo credit-note list
hisaabo credit-note get cn_xxxxxxxxxx
hisaabo credit-note create --party "Sharma Traders" --invoice BB-12948 --reason "Goods returned"
hisaabo credit-note status cn_xxxxxxxxxx issued
hisaabo credit-note delete cn_xxxxxxxxxx

Debit Note

hisaabo debit-note list
hisaabo debit-note get dn_xxxxxxxxxx
hisaabo debit-note create --party "Vinod & Sons" --invoice BB-12900 --reason "Short supply"
hisaabo debit-note status dn_xxxxxxxxxx issued
hisaabo debit-note delete dn_xxxxxxxxxx

Delivery Challan

hisaabo challan list
hisaabo challan get dc_xxxxxxxxxx
hisaabo challan create \
  --party "Gupta Enterprises" \
  --item "Mustard Oil 15L" --quantity 10 --unit can
hisaabo challan status dc_xxxxxxxxxx delivered
hisaabo challan delete dc_xxxxxxxxxx

Proforma Invoice

hisaabo proforma list
hisaabo proforma get pf_xxxxxxxxxx
hisaabo proforma create \
  --party "Mehta & Sons" \
  --item "Toor Dal 50kg" --quantity 5 --unit bag --price 4200
hisaabo proforma status pf_xxxxxxxxxx approved
hisaabo proforma delete pf_xxxxxxxxxx

Sales Return

hisaabo sales-return list
hisaabo sales-return get sr_xxxxxxxxxx
hisaabo sales-return create --party "Sharma Traders" --invoice BB-12948
hisaabo sales-return status sr_xxxxxxxxxx processed
hisaabo sales-return delete sr_xxxxxxxxxx

Purchase Return

hisaabo purchase-return list
hisaabo purchase-return get pr_xxxxxxxxxx
hisaabo purchase-return create --party "Vinod & Sons" --invoice BB-12900
hisaabo purchase-return status pr_xxxxxxxxxx processed
hisaabo purchase-return delete pr_xxxxxxxxxx

Convert a document

Convert one document type to another. The most common use case is converting a delivery challan into a tax invoice after goods are delivered.

# Convert a delivery challan to a sale invoice
hisaabo document convert \
  --from dc_xxxxxxxxxx \
  --from-type delivery_challan \
  --to-type invoice

The --skip-stock-adjustment flag is available when converting a challan to an invoice to avoid double-deducting stock that was already deducted when the challan was created.

`hisaabo session`

Manage active sessions across devices.

`hisaabo session list`

List all active sessions for the current user.

hisaabo session list
hisaabo session list --expired
hisaabo session list --json

Shows device/browser, IP address, last activity time, creation date, and marks the current session. Session IDs shown here are opaque hashes, not the session tokens themselves, and are abbreviated in the table (use --json for the full value).

`hisaabo session revoke`

Terminate a specific session by ID.

hisaabo session revoke <sessionId> --yes

The revoked session is immediately invalidated. The user on that device will be redirected to the login page.

`hisaabo session revoke-all`

Sign out from all devices (including the current one).

hisaabo session revoke-all --yes

`hisaabo api-key`

Generate and manage API keys for automation scripts, CI/CD pipelines, and third-party integrations.

`hisaabo api-key list`

hisaabo api-key list
hisaabo api-key list --json

Shows key name, creation date, expiry date, and last-used timestamp. The key secret is only shown once at creation time.

`hisaabo api-key create`

hisaabo api-key create --name "CI Pipeline" --expires-in-days 90
hisaabo api-key create --name "Read-only export script" --expires-in-days 30

Keys expire after --expires-in-days (default 90, maximum 365). Copy the returned key immediately — it is not shown again. Creating keys requires an admin role. Keys are revoked automatically when the member is removed or their role changes.

`hisaabo api-key revoke`

hisaabo api-key revoke apikey_xxxxxxxxxx --yes

Revoked keys stop working instantly.

Common flags

Flag	Description
`--json`	Output raw JSON instead of formatted tables (on most commands)
`-y, --yes`	Skip the confirmation prompt on destructive commands
`--help`	Show help for any command
`--version`	Print the CLI version

Destructive commands need --yes when non-interactive. Commands that delete, merge, revoke, cancel, remove or restore data (for example invoice delete, party merge, session revoke, api-key revoke, tenant remove, restore) prompt for confirmation in a terminal. When stdin is not a TTY (cron, CI, an AI agent running shell commands) they refuse with a usage error unless you pass --yes.

Practical Examples

Morning dashboard check

hisaabo dashboard --period today

Or with the full picture:

#!/bin/bash
echo "=== $(date +"%d %b %Y") ==="
hisaabo dashboard --period today
echo ""
echo "--- Overdue invoices ---"
hisaabo invoice list --status overdue --sort oldest-first --limit 10
echo ""
echo "--- Low stock ---"
hisaabo item list --low-stock

Creating an invoice from the terminal

hisaabo invoice create \
  --party "Gupta Enterprises" \
  --item "Basmati Rice 25kg" --quantity 20 --unit bag --price 1250 \
  --item "Toor Dal 50kg" --quantity 5 --unit bag --price 4200 \
  --due-date 2026-04-10

Then immediately get the PDF:

INVOICE_ID=$(hisaabo invoice create \
  --party "Gupta Enterprises" \
  --item "Basmati Rice 25kg" --quantity 20 --unit bag --price 1250 \
  --json | jq -r '.id')

hisaabo invoice pdf "$INVOICE_ID" --output /tmp/
echo "PDF saved: /tmp/${INVOICE_ID}.pdf"

Checking overdue invoices

# Human-readable table
hisaabo invoice list --status overdue --sort oldest-first

# Pipe to jq for custom formatting
hisaabo invoice list --status overdue --json | jq -r \
  '.[] | "\(.invoiceNumber)  \(.party.name)  ₹\(.totalAmount)  \(.daysOverdue) days overdue"'

# Total amount overdue
hisaabo invoice list --status overdue --json | \
  jq '[.[].totalAmount | tonumber] | add'

GST filing prep (export GSTR-1)

#!/bin/bash
MONTH=3
YEAR=2026
OUTPUT_DIR="/var/gst-reports/${YEAR}-${MONTH}"
mkdir -p "$OUTPUT_DIR"

# Human-readable summary
hisaabo gst r1 --month "$MONTH" --year "$YEAR"

# Export CSV for CA or GST portal upload
hisaabo gst r1 --month "$MONTH" --year "$YEAR" \
  --csv --output "$OUTPUT_DIR/gstr1-${YEAR}-${MONTH}.csv"

hisaabo gst r3b --month "$MONTH" --year "$YEAR" \
  --csv --output "$OUTPUT_DIR/gstr3b-${YEAR}-${MONTH}.csv"

echo "GST exports ready in $OUTPUT_DIR"

Scripting with `--json | jq`

# Top 5 customers by outstanding balance
hisaabo party list --outstanding --json | \
  jq 'sort_by(.outstandingBalance | tonumber) | reverse | .[0:5] |
      .[] | "\(.name): ₹\(.outstandingBalance)"'

# Items needing reorder with suggested quantity
hisaabo item list --low-stock --json | jq -r \
  '.[] | "REORDER \(.name): have \(.stockQuantity) \(.unit), min \(.lowStockThreshold) \(.unit)"'

# Monthly revenue from dashboard
hisaabo dashboard --period this-month --json | jq -r '.totalSales'

# Count invoices by status
hisaabo invoice list --json | jq 'group_by(.status) | .[] | {status: .[0].status, count: length}'

Power User Workflows

Morning brief with overdue and low-stock checks

#!/bin/bash
# morning-brief.sh — add to cron: 0 8 * * *

DASH=$(hisaabo dashboard --period today --json)
OVERDUE=$(hisaabo invoice list --status overdue --sort oldest-first --limit 5 --json)
LOW=$(hisaabo item list --low-stock --json)

echo "=== MORNING BRIEF — $(date +"%d %b %Y") ==="
echo ""
echo "Revenue today:    $(echo $DASH | jq -r '.totalSales')"
echo "Outstanding:      $(echo $DASH | jq -r '.receivable')"
echo ""

OVERDUE_COUNT=$(echo $OVERDUE | jq 'length')
if [ "$OVERDUE_COUNT" -gt 0 ]; then
  echo "OVERDUE ($OVERDUE_COUNT):"
  echo $OVERDUE | jq -r \
    '.[] | "  \(.invoiceNumber) — \(.party.name) — ₹\(.totalAmount) (\(.daysOverdue) days)"'
  echo ""
fi

LOW_COUNT=$(echo $LOW | jq 'length')
if [ "$LOW_COUNT" -gt 0 ]; then
  echo "LOW STOCK ($LOW_COUNT):"
  echo $LOW | jq -r '.[] | "  \(.name): \(.stockQuantity) \(.unit) left"'
fi

Monthly GST filing prep

#!/bin/bash
# gst-filing-prep.sh — cron: 0 8 28 * *

MONTH=$(date +%m)
YEAR=$(date +%Y)
CA_EMAIL="[email protected]"
OUTPUT_DIR="/var/gst-reports/${YEAR}-${MONTH}"
mkdir -p "$OUTPUT_DIR"

hisaabo gst r1 --month "$MONTH" --year "$YEAR" \
  --csv --output "$OUTPUT_DIR/gstr1.csv"

hisaabo gst r3b --month "$MONTH" --year "$YEAR" \
  --csv --output "$OUTPUT_DIR/gstr3b.csv"

SUMMARY=$(hisaabo gst r3b --month "$MONTH" --year "$YEAR")

{
  echo "GST data for ${YEAR}-${MONTH} attached."
  echo ""
  echo "$SUMMARY"
  echo ""
  echo "Please file before the 11th."
} | mail -s "GST Data ${YEAR}-${MONTH}" \
  -a "$OUTPUT_DIR/gstr1.csv" \
  -a "$OUTPUT_DIR/gstr3b.csv" \
  "$CA_EMAIL"

Outstanding aging report (weekly)

#!/bin/bash
# aging-report.sh — cron: 0 9 * * 1

hisaabo report outstanding --json | jq -r '
  "RECEIVABLES AGING — " + (now | strftime("%d %b %Y")) + "\n" +
  "0–30 days:  ₹\(.aging."0_30")\n" +
  "31–60 days: ₹\(.aging."31_60")\n" +
  "61–90 days: ₹\(.aging."61_90")\n" +
  "90+ days:   ₹\(.aging."90_plus")\n"
' | mail -s "Weekly Aging Report" [email protected]

For AI Agent Developers

CLI vs. MCP: which to use

Scenario	Use CLI	Use MCP
Cron jobs and scheduled automation	Yes	No
AI assistants in conversation (Claude Desktop, etc.)	No	Yes
Shell pipeline data processing	Yes	No
OpenClaw agents that take actions	No	Yes
CI/CD pipelines and deployment scripts	Yes	No
Natural-language business queries	No	Yes
Bulk data export and reporting	Yes	No

Exposing the CLI as an agent tool

export const hisaaboCLI = {
  name: "hisaabo_cli",
  description:
    "Run a hisaabo CLI command and return the JSON output. " +
    "Available subcommands: dashboard, " +
    "invoice list/get/create/update/pdf/delete, " +
    "party list/get/create/delete/ledger/ledger-report/stats/top-items/merge, " +
    "item list/get/create/delete/stock/stock-history/stock-movements/low-stock-count/price-history/sales-stats/variants/merge/switch-base-unit/rename-unit, " +
    "payment list/create/delete/unpaid-invoices/untracked/default-account/assign-account, " +
    "expense list/create/delete, " +
    "gst r1/r3b, shipment list/get/create/update, " +
    "bank list/get/create/transfer/transactions, " +
    "report daybook/outstanding/tax-summary/item-sales/stock, " +
    "target list/create/my, import parties/items, " +
    "store settings/orders/order-confirm/order-cancel/check-slug/items/items-toggle, " +
    "tenant list/select/members/invite/remove/role, " +
    "quotation list/get/create/status/delete, " +
    "credit-note list/get/create/status/delete, " +
    "debit-note list/get/create/status/delete, " +
    "challan list/get/create/status/delete, " +
    "proforma list/get/create/status/delete, " +
    "sales-return list/get/create/status/delete, " +
    "purchase-return list/get/create/status/delete, " +
    "document convert, " +
    "api-key list/create/revoke",
  parameters: {
    type: "object",
    properties: {
      command: {
        type: "string",
        description: "The hisaabo subcommand to run, e.g. 'invoice list --status overdue --json'",
      },
    },
    required: ["command"],
  },
  execute: async ({ command }: { command: string }) => {
    const { stdout, stderr } = await exec(`hisaabo ${command}`);
    if (stderr) throw new Error(stderr);
    return JSON.parse(stdout);
  },
};

Cron Job Reference

HISAABO_API_URL=https://your-hisaabo-instance.com
HISAABO_TOKEN=hisaabo_key_xxxxxxxxxxxxxxxxxx
HISAABO_TENANT_ID=tenant-uuid-here
HISAABO_BUSINESS_ID=business-uuid-here

# Daily summary at 8:00 AM
0 8 * * * root hisaabo dashboard --period today --json | \
  jq -r '"Revenue: ₹\(.totalSales)\nOutstanding: ₹\(.receivable)"' | \
  mail -s "Daily Summary" [email protected]

# Overdue invoice alert at 9:00 AM
0 9 * * * root /opt/hisaabo-scripts/morning-brief.sh

# Stock check twice daily
0 9,17 * * * root /opt/hisaabo-scripts/low-stock-check.sh

# Monthly GST export on the 28th at 8 AM
0 8 28 * * root /opt/hisaabo-scripts/gst-filing-prep.sh

# Weekly aging report every Monday
0 9 * * 1 root /opt/hisaabo-scripts/aging-report.sh

Configuration File

The CLI reads from ~/.config/hisaabo/config.json, created automatically on first hisaabo login:

{
  "apiUrl": "https://your-hisaabo-instance.com",
  "token": "hisaabo_key_xxxxxxxxxxxxxxxxxx",
  "tenantId": "tenant-uuid-here",
  "businessId": "business-uuid-here",
  "businessName": "Sharma Traders"
}

The token is stored in plaintext; the file is created with mode 0600 inside a 0700 directory. Environment variables (HISAABO_TOKEN with HISAABO_API_URL) take priority over the config file and are never written to disk, so prefer them for CI and shared machines.

AI & Automation overview
MCP Server — For interactive AI agents and Claude Desktop
Integrations — WhatsApp, Slack, Google Sheets, and more
API Reference
Self-Hosting — Running Hisaabo on your own infrastructure

CLI Tool

Installation

Authentication

Sign in with your browser (interactive)

Sign in with an API key (scripts and CI)

Environment variables (recommended for automation)

Transport security

Listing and switching businesses

Profile and sign-out

Command Reference

hisaabo dashboard

hisaabo invoice

hisaabo invoice list

hisaabo invoice get

hisaabo invoice create

hisaabo invoice pdf

hisaabo invoice update

hisaabo invoice delete

hisaabo party

hisaabo party list

hisaabo party get

hisaabo party create

hisaabo party ledger-report

hisaabo party stats

hisaabo party top-items

hisaabo party merge

hisaabo party delete

hisaabo item

hisaabo item list

hisaabo item get

hisaabo item create

hisaabo item delete

hisaabo item stock

hisaabo item stock-history

hisaabo item stock-movements

hisaabo item stock-summary

hisaabo item low-stock-count

hisaabo item price-history

hisaabo item price-summary

hisaabo item sales-stats

hisaabo item variants

hisaabo item merge

hisaabo item switch-base-unit

hisaabo item rename-unit

hisaabo payment

hisaabo payment list

hisaabo payment create

hisaabo payment delete

hisaabo payment unpaid-invoices

hisaabo payment untracked

hisaabo payment default-account

hisaabo payment assign-account

hisaabo expense

hisaabo expense list

hisaabo expense create

hisaabo expense delete

hisaabo gst

hisaabo gst r1

hisaabo gst r3b

hisaabo automated-invoice

hisaabo automated-invoice list

hisaabo automated-invoice get

hisaabo automated-invoice create

hisaabo automated-invoice pause

hisaabo automated-invoice resume

hisaabo automated-invoice run-now

hisaabo automated-invoice delete

hisaabo shipment

hisaabo shipment list

hisaabo shipment get

hisaabo shipment create

hisaabo shipment update

hisaabo bank

hisaabo bank list

hisaabo bank get

hisaabo bank create

hisaabo bank transfer

hisaabo bank transactions

hisaabo bank gateway-config

hisaabo bank update-gateway