jaz-clio 4.23.0 → 4.24.0

package/README.md

@@ -3,23 +3,40 @@
 <p align="center">
   <a href="https://www.npmjs.com/package/jaz-clio"><img src="https://img.shields.io/npm/v/jaz-clio?style=for-the-badge&logo=npm" alt="npm"></a>
   <a href="https://www.npmjs.com/package/jaz-clio"><img src="https://img.shields.io/npm/dm/jaz-clio?style=for-the-badge&label=downloads" alt="npm downloads"></a>
+  <img src="https://img.shields.io/badge/tools-203-blue?style=for-the-badge" alt="203 Tools">
   <img src="https://img.shields.io/badge/calculators-13-red?style=for-the-badge" alt="13 Calculators">
   <img src="https://img.shields.io/badge/jobs-12-teal?style=for-the-badge" alt="12 Jobs">
   <a href="https://github.com/teamtinvio/jaz-ai/blob/main/LICENSE"><img src="https://img.shields.io/github/license/teamtinvio/jaz-ai?style=for-the-badge&color=green" alt="License"></a>
 </p>
 
-CLI for the [Jaz](https://jaz.ai) accounting platform. Create invoices, record bills, manage contacts, run financial calculators, execute accounting jobs, and install AI agent skills — all from your terminal.
+**Complete agent stack for all of Jaz, built for AI agents and accountants.**
+Create invoices, record bills, manage contacts, run financial calculators, execute accounting jobs, and install AI agent skills — all from your terminal.
 
 > Also fully compatible with [Juan Accounting](https://juan.ac).
 
-## Prerequisites
+## Contents
 
-**Node.js 18 or later** is required. If `node --version` works, skip ahead.
+- [Quickstart](#quickstart)
+- [Install](#install)
+- [Authenticate](#authenticate)
+- [Commands](#commands)
+- [MCP Server](#mcp-server)
+- [Install AI Skills](#install-ai-skills)
+- [Privacy & Security](#privacy--security)
+- [Support](#support)
 
-Otherwise: download the LTS installer from [nodejs.org](https://nodejs.org). It includes `npm`.
+## Quickstart
+
+```bash
+npm install -g jaz-clio
+clio auth add <your-api-key>    # Get key from Settings > API in Jaz app
+clio invoices list               # You're in
+```
 
 ## Install
 
+**Node.js 18+** required. If `node --version` works, you're set. Otherwise: [nodejs.org](https://nodejs.org) (LTS).
+
 ```bash
 npm install -g jaz-clio
 ```
@@ -27,18 +44,43 @@ npm install -g jaz-clio
 ## Authenticate
 
 ```bash
-# Add your Jaz API key (get one from Settings > API in the Jaz app)
-clio auth add <your-api-key>
+clio auth add <your-api-key>    # Add your Jaz API key
+clio auth whoami                 # Verify it works
+```
+
+| I have... | Use |
+|-----------|-----|
+| API key from Jaz app | `clio auth add <key>` |
+| Environment variable | `export JAZ_API_KEY=jk-...` |
+| Multiple orgs | `clio auth add <key>` + `clio auth switch <label>` |
+
+### Auth Precedence
+
+When multiple credentials are available, Clio resolves them in this order:
+
+| Priority | Source | Set via |
+|----------|--------|---------|
+| 1 | `--api-key` flag | Explicit per-command |
+| 2 | `JAZ_API_KEY` env var | Shell or `.env` |
+| 3 | `--org` flag / `JAZ_ORG` env | Named profile lookup |
+| 4 | Active profile | `clio auth switch` |
 
-# Verify it works
-clio auth whoami
+> **Warning:** If `JAZ_API_KEY` is set in your shell, it overrides `--org` and the active profile. Unset it (`unset JAZ_API_KEY`) before switching tenants with `clio auth switch`, or use per-command `--api-key` instead.
 
-# Manage multiple orgs
-clio auth add <another-key>     # Adds a second profile
-clio auth list                  # See all profiles
-clio auth switch <label>        # Switch active org
+<details>
+<summary>All auth subcommands</summary>
+
+```bash
+clio auth add <key>              # Add API key (validates against API)
+clio auth list                   # List all saved profiles
+clio auth switch <label>         # Switch active org
+clio auth remove <label>         # Remove a profile
+clio auth whoami                 # Show current org
+clio auth clear                  # Remove all profiles
 ```
 
+</details>
+
 ## Commands
 
 ### Transactions
@@ -55,6 +97,7 @@ clio journals list                     # List journal entries
 clio cash-in list                      # List cash-in entries
 clio cash-out list                     # List cash-out entries
 clio cash-transfer list                # List cash transfers
+clio capsules list                     # List capsules (transaction groups)
 ```
 
 ### Contacts, Accounts & Items
@@ -65,11 +108,46 @@ clio contacts create --name "ACME Ltd" # Create a contact
 clio accounts list                     # Chart of accounts
 clio items list                        # Products and services
 clio tags list                         # Tracking tags
+clio contact-groups list               # Contact groups
+clio custom-fields list                # Custom field definitions
+```
+
+### Bank & Reconciliation
+
+```bash
+clio bank import --file statement.csv  # Import bank statement
+clio bank accounts                     # List bank accounts
+clio bank records                      # List bank records
+clio bank add-records                  # Create bank records (JSON)
+clio bank auto-recon                   # Auto-reconciliation
+clio bank-rules list                   # List auto-tagging rules
+clio bank-rules create                 # Create auto-tagging rule
+```
+
+### Fixed Assets
+
+```bash
+clio fixed-assets list                 # List fixed assets (alias: clio fa list)
+clio fixed-assets get <id>             # Get fixed asset details
+clio fixed-assets create               # Register a new asset
+clio fixed-assets sell <id>            # Record asset sale
+clio fixed-assets discard <id>         # Discard/scrap an asset
+clio fixed-assets transfer <id>        # Transfer between accounts
+clio fixed-assets undo-disposal <id>   # Reverse a disposal
+```
+
+### Subscriptions
+
+```bash
+clio subscriptions list                # List recurring subscriptions (alias: clio subs)
+clio subscriptions create              # Create a subscription
+clio subscriptions cancel <id>         # Cancel a subscription
+clio subscriptions search-scheduled    # Search scheduled transactions
 ```
 
 ### Financial Calculators
 
-10 IFRS-compliant calculators that output structured blueprints with journal entries, workings, and execution plans.
+13 IFRS-compliant calculators that output structured blueprints with journal entries, workings, and execution plans.
 
 ```bash
 clio calc loan --principal 100000 --rate 6 --term 60 --json
@@ -80,8 +158,23 @@ clio calc provision --amount 100000 --rate 4 --periods 24 --json
 clio calc fx-reval --account "USD Cash" --balance 10000 --old-rate 1.35 --new-rate 1.34 --json
 clio calc fixed-deposit --principal 100000 --rate 3.5 --term 12 --json
 clio calc disposal --cost 50000 --accum-dep 30000 --proceeds 15000 --json
-clio calc amortization --amount 12000 --periods 12 --start 2025-01-01 --json
-clio calc hire-purchase --value 80000 --term 48 --rate 4.5 --json
+clio calc prepaid-expense --amount 12000 --periods 12 --start 2025-01-01 --json
+clio calc deferred-revenue --amount 24000 --periods 12 --start 2025-01-01 --json
+clio calc accrued-expense --amount 5000 --periods 3 --json
+clio calc leave-accrual --employees 50 --avg-daily-rate 200 --avg-days 15 --json
+clio calc dividend --amount 100000 --json
+```
+
+### Transaction Recipes (Capsule Transactions)
+
+13 recipe subcommands that compute, plan, and optionally execute multi-step transactions from calculator output.
+
+```bash
+clio capsule-transaction loan --principal 100000 --rate 6 --term 60    # alias: clio ct loan
+clio ct lease --payment 5000 --term 36 --rate 5
+clio ct depreciation --cost 50000 --salvage 5000 --life 5
+clio ct prepaid-expense --amount 12000 --periods 12 --start 2025-01-01
+clio ct fx-reval --account "USD Cash" --balance 10000 --old-rate 1.35 --new-rate 1.34
 ```
 
 ### Accounting Jobs
@@ -103,23 +196,37 @@ clio jobs fa-review                                             # Fixed asset re
 clio jobs statutory-filing sg-cs --ya 2026 --revenue 500000 --profit 120000 --json  # SG Form C-S
 ```
 
-### Other
+### Reports
+
+16 report types:
+
+```bash
+clio reports generate <type>           # Generate a report
+clio reports pdf <type>                # Download report as PDF
+```
+
+Types: `trial-balance`, `balance-sheet`, `profit-loss`, `cashflow`, `aged-ar`, `aged-ap`, `cash-balance`, `general-ledger`, `vat-ledger`, `equity-movement`, `bank-balance-summary`, `bank-recon-summary`, `bank-recon-details`, `fa-summary`, `fa-recon-summary`, `ar-report`.
+
+### Other Commands
 
 ```bash
 clio org info                          # Current org details
+clio org-users list                    # Organization members
 clio currencies list                   # Enabled currencies
 clio currency-rates list               # Exchange rates
 clio payments search                   # Search payments
-clio bank import --file statement.csv  # Import bank statement
-clio reports generate --type pnl       # Generate reports
-clio capsules list                     # List capsules (transaction groups)
-clio schedulers list-invoices           # List scheduled (recurring) invoices
-clio exports download --type INVOICES   # Download data export
-clio attachments list <id>              # List attachments on a transaction
-clio tax-profiles list                  # List tax profiles
-clio magic create --file receipt.pdf    # AI-extract from attachment
-clio cashflow search                    # Search cashflow transactions
-clio context                            # Generate agent context
+clio tax-profiles list                 # Tax profiles
+clio cashflow search                   # Search cashflow transactions
+clio schedulers list-invoices          # Scheduled (recurring) invoices
+clio exports download --type INVOICES  # Download data export
+clio attachments list <id>             # List attachments on a transaction
+clio bookmarks list                    # Saved bookmarks
+clio inventory items                   # Inventory items
+clio inventory balance <item-id>       # Inventory balance for an item
+clio search "query"                    # Universal cross-entity search
+clio magic create --file receipt.pdf   # AI-extract from attachment
+clio kb "topic"                        # Search help center (alias: clio hc)
+clio context                           # Generate agent context summary
 clio versions                          # Show version info
 clio update                            # Update to latest
 ```
@@ -128,7 +235,7 @@ Every command supports `--json` for structured output — ideal for piping to ot
 
 ## MCP Server
 
-Expose all 203 CLI tools to AI coworking and coding agents via the Model Context Protocol (MCP). The server runs locally on your machine — no cloud, no ports. API calls go directly from your machine to the Jaz API.
+Expose all 203 CLI tools to AI coding and coworking agents via the Model Context Protocol (MCP). The server runs locally on your machine — no cloud, no ports. API calls go directly from your machine to the Jaz API.
 
 **Claude Code:**
 

package/assets/skills/api/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: jaz-api
-version: 4.23.0
+version: 4.24.0
 description: Complete reference for the Jaz REST API — the accounting platform backend. Use this skill whenever building, modifying, debugging, or extending any code that calls the API — including API clients, integrations, data seeding, test data, or new endpoint work. Contains every field name, response shape, error, gotcha, and edge case discovered through live production testing.
 license: MIT
 compatibility: Requires Jaz API key (x-jk-api-key header). Works with Claude Code, Google Antigravity, OpenAI Codex, GitHub Copilot, Cursor, and any agent that reads markdown.

package/assets/skills/conversion/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: jaz-conversion
-version: 4.23.0
+version: 4.24.0
 description: Accounting data conversion skill — migrates customer data from Xero, QuickBooks, Sage, MYOB, and Excel exports to Jaz. Covers config, quick, and full conversion workflows, Excel parsing, CoA/contact/tax/items mapping, clearing accounts, TTB, and TB verification.
 ---
 

package/assets/skills/jobs/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: jaz-jobs
-version: 4.23.0
+version: 4.24.0
 description: 12 accounting jobs for SMB bookkeepers and accountants — month-end, quarter-end, and year-end close playbooks plus 9 ad-hoc operational jobs (bank recon, document collection, GST/VAT filing, payment runs, credit control, supplier recon, audit prep, fixed asset review, statutory filing). Jobs can have paired tools as nested subcommands (e.g., `clio jobs bank-recon match`, `clio jobs document-collection ingest`, `clio jobs statutory-filing sg-cs`). Paired with an interactive CLI blueprint generator (clio jobs).
 license: MIT
 compatibility: Works with Claude Code, Claude Cowork, Claude.ai, and any agent that reads markdown. For API payloads, load the jaz-api skill. For individual transaction patterns, load the jaz-recipes skill.

package/assets/skills/transaction-recipes/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: jaz-recipes
-version: 4.23.0
+version: 4.24.0
 description: 16 IFRS-compliant recipes for complex multi-step accounting in Jaz — prepaid amortization, deferred revenue, loan schedules, IFRS 16 leases, hire purchase, fixed deposits, asset disposal, FX revaluation, ECL provisioning, IAS 37 provisions, dividends, intercompany, and capital WIP. Each recipe includes journal entries, capsule structure, and verification steps. Paired with 13 financial calculators that produce execution-ready blueprints with workings.
 license: MIT
 compatibility: Works with Claude Code, Claude Cowork, Claude.ai, and any agent that reads markdown. For API payloads, load the jaz-api skill alongside this one.

package/dist/commands/accounts.js

@@ -1,8 +1,16 @@
 import chalk from 'chalk';
 import { listAccounts, searchAccounts, createAccount, deleteAccount } from '../core/api/chart-of-accounts.js';
 import { apiAction } from './api-action.js';
+import { outputList } from './output.js';
 import { parsePositiveInt, parseNonNegativeInt, readBodyInput, requireFields } from './parsers.js';
-import { paginatedFetch, paginatedJson, displaySlice } from './pagination.js';
+import { paginatedFetch } from './pagination.js';
+import { formatId } from './format-helpers.js';
+const ACCOUNTS_COLUMNS = [
+    { key: 'resourceId', header: 'ID', format: formatId },
+    { key: 'code', header: 'Code' },
+    { key: 'name', header: 'Name' },
+    { key: 'accountType', header: 'Type' },
+];
 export function registerAccountsCommand(program) {
     const accounts = program
         .command('accounts')
@@ -16,21 +24,11 @@ export function registerAccountsCommand(program) {
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')
+        .option('--format <type>', 'Output format: table, json, csv, yaml')
         .option('--json', 'Output as JSON')
         .action(apiAction(async (client, opts) => {
         const result = await paginatedFetch(opts, (p) => listAccounts(client, p), { label: 'Fetching accounts' });
-        if (opts.json) {
-            console.log(paginatedJson(result, opts));
-        }
-        else {
-            console.log(chalk.bold(`Accounts (${result.data.length} of ${result.totalElements}):\n`));
-            const { items, overflow } = displaySlice(result.data);
-            for (const a of items) {
-                console.log(`  ${chalk.cyan(a.resourceId)}  ${a.code ?? ''}  ${a.name}  ${chalk.dim(a.accountType)}`);
-            }
-            if (overflow > 0)
-                console.log(chalk.dim(`  ... and ${overflow.toLocaleString()} more (use --json for full output)`));
-        }
+        outputList(result, ACCOUNTS_COLUMNS, opts, 'Accounts'); // eslint-disable-line @typescript-eslint/no-explicit-any
     }));
     // ── clio accounts search ────────────────────────────────────────
     accounts
@@ -43,27 +41,13 @@ export function registerAccountsCommand(program) {
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
         .option('--api-key <key>', 'API key (overrides stored/env)')
+        .option('--format <type>', 'Output format: table, json, csv, yaml')
         .option('--json', 'Output as JSON')
         .action((query, opts) => apiAction(async (client) => {
         const filter = { or: { name: { contains: query }, code: { contains: query } } };
         const sort = { sortBy: [opts.sort ?? 'code'], order: (opts.order ?? 'ASC') };
         const result = await paginatedFetch(opts, ({ limit, offset }) => searchAccounts(client, { filter, limit, offset, sort }), { label: 'Searching accounts', defaultLimit: 20 });
-        if (opts.json) {
-            console.log(paginatedJson(result, opts));
-        }
-        else {
-            if (result.data.length === 0) {
-                console.log('No accounts found.');
-                return;
-            }
-            console.log(chalk.bold(`Found ${result.data.length} account(s):\n`));
-            const { items, overflow } = displaySlice(result.data);
-            for (const a of items) {
-                console.log(`  ${chalk.cyan(a.resourceId)}  ${a.code ?? ''}  ${a.name}  ${chalk.dim(a.accountType)}`);
-            }
-            if (overflow > 0)
-                console.log(chalk.dim(`  ... and ${overflow.toLocaleString()} more (use --json for full output)`));
-        }
+        outputList(result, ACCOUNTS_COLUMNS, opts, 'Accounts'); // eslint-disable-line @typescript-eslint/no-explicit-any
     })(opts));
     // ── clio accounts create ──────────────────────────────────────
     accounts
@@ -76,6 +60,7 @@ export function registerAccountsCommand(program) {
         .option('--status <status>', 'Account status (ACTIVE or INACTIVE)')
         .option('--input <file>', 'Read full request body from JSON file (or pipe via stdin)')
         .option('--api-key <key>', 'API key (overrides stored/env)')
+        .option('--format <type>', 'Output format: table, json, csv, yaml')
         .option('--json', 'Output as JSON')
         .action(apiAction(async (client, opts) => {
         const body = readBodyInput(opts);
@@ -113,6 +98,7 @@ export function registerAccountsCommand(program) {
         .command('delete <resourceId>')
         .description('Delete an account from the chart of accounts')
         .option('--api-key <key>', 'API key (overrides stored/env)')
+        .option('--format <type>', 'Output format: table, json, csv, yaml')
         .option('--json', 'Output as JSON')
         .action((resourceId, opts) => apiAction(async (client) => {
         await deleteAccount(client, resourceId);

package/dist/commands/api-action.js

@@ -1,6 +1,7 @@
 import chalk from 'chalk';
 import { JazClient, JazApiError } from '../core/api/client.js';
 import { requireAuth, AuthError, resolvedProfileLabel, resolvedAuthSource, getProfile, listProfiles } from '../core/auth/index.js';
+import { isMachineFormat } from './output.js';
 /**
  * Shared action wrapper for all online CLI commands.
  * Handles auth resolution, client creation, org banner, and error formatting.
@@ -16,9 +17,9 @@ export function apiAction(fn) {
             }
             const auth = requireAuth(opts.apiKey);
             const client = new JazClient(auth);
-            // Org banner — show which org we're hitting (suppressed in --json mode)
+            // Org banner — show which org we're hitting (suppressed in machine formats)
             // Visual guard: yellow warning when unpinned + multi-org, dim banner otherwise
-            if (!opts.json) {
+            if (!isMachineFormat(opts)) {
                 const label = resolvedProfileLabel();
                 if (label) {
                     const entry = getProfile(label);
@@ -46,22 +47,23 @@ export function apiAction(fn) {
             await fn(client, opts, auth);
         }
         catch (err) {
+            const machine = isMachineFormat(opts);
             if (err instanceof AuthError) {
-                if (opts.json)
+                if (machine)
                     console.log(JSON.stringify({ error: { code: 'AUTH_ERROR', message: err.message } }));
                 else
                     console.error(chalk.red(`Error: ${err.message}`));
                 process.exit(3);
             }
             if (err instanceof JazApiError) {
-                if (opts.json)
+                if (machine)
                     console.log(JSON.stringify({ error: { code: 'API_ERROR', status: err.status, message: err.message } }));
                 else
                     console.error(chalk.red(`API Error (${err.status}): ${err.message}`));
                 process.exit(2);
             }
             const message = err.message;
-            if (opts.json)
+            if (machine)
                 console.log(JSON.stringify({ error: { code: 'UNKNOWN_ERROR', message } }));
             else
                 console.error(chalk.red(`Error: ${message}`));

package/dist/commands/bank-rules.js

@@ -1,8 +1,14 @@
 import chalk from 'chalk';
 import { listBankRules, getBankRule, searchBankRules, createBankRule, updateBankRule, deleteBankRule, } from '../core/api/bank-rules.js';
 import { apiAction } from './api-action.js';
+import { outputList } from './output.js';
 import { parsePositiveInt, parseNonNegativeInt, readBodyInput } from './parsers.js';
-import { paginatedFetch, paginatedJson, displaySlice } from './pagination.js';
+import { paginatedFetch } from './pagination.js';
+import { formatId } from './format-helpers.js';
+const BANK_RULES_COLUMNS = [
+    { key: 'resourceId', header: 'ID', format: formatId },
+    { key: 'name', header: 'Name' },
+];
 export function registerBankRulesCommand(program) {
     const cmd = program
         .command('bank-rules')
@@ -14,24 +20,17 @@ export function registerBankRulesCommand(program) {
         .option('--offset <n>', 'Offset', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--api-key <key>', 'API key')
+        .option('--format <type>', 'Output format: table, json, csv, yaml')
         .option('--json', 'JSON output')
         .action(apiAction(async (client, opts) => {
         const result = await paginatedFetch(opts, (p) => listBankRules(client, p), { label: 'Fetching bank rules' });
-        if (opts.json) {
-            console.log(paginatedJson(result, opts));
-            return;
-        }
-        console.log(chalk.bold(`Bank Rules (${result.data.length} of ${result.totalElements}):\n`));
-        const { items, overflow } = displaySlice(result.data);
-        for (const r of items)
-            console.log(`  ${chalk.cyan(r.resourceId)}  ${r.name}  ${chalk.dim(r.actionType)}`);
-        if (overflow > 0)
-            console.log(chalk.dim(`  ... and ${overflow} more`));
+        outputList(result, BANK_RULES_COLUMNS, opts, 'Bank Rules'); // eslint-disable-line @typescript-eslint/no-explicit-any
     }));
     cmd
         .command('get <resourceId>')
         .description('Get a bank rule')
         .option('--api-key <key>', 'API key')
+        .option('--format <type>', 'Output format: table, json, csv, yaml')
         .option('--json', 'JSON output')
         .action((resourceId, opts) => apiAction(async (client) => {
         const res = await getBankRule(client, resourceId);
@@ -49,26 +48,18 @@ export function registerBankRulesCommand(program) {
         .option('--limit <n>', 'Max results', parsePositiveInt)
         .option('--offset <n>', 'Offset', parseNonNegativeInt)
         .option('--api-key <key>', 'API key')
+        .option('--format <type>', 'Output format: table, json, csv, yaml')
         .option('--json', 'JSON output')
         .action((query, opts) => apiAction(async (client) => {
         const result = await paginatedFetch(opts, ({ limit, offset }) => searchBankRules(client, { filter: { name: { contains: query } }, limit, offset }), { label: 'Searching bank rules', defaultLimit: 20 });
-        if (opts.json) {
-            console.log(paginatedJson(result, opts));
-            return;
-        }
-        if (result.data.length === 0) {
-            console.log('No bank rules found.');
-            return;
-        }
-        console.log(chalk.bold(`Found ${result.data.length} rule(s):\n`));
-        for (const r of result.data)
-            console.log(`  ${chalk.cyan(r.resourceId)}  ${r.name}`);
+        outputList(result, BANK_RULES_COLUMNS, opts, 'Bank Rules'); // eslint-disable-line @typescript-eslint/no-explicit-any
     })(opts));
     cmd
         .command('create')
         .description('Create a bank rule')
         .option('--input <file>', 'Read request body from JSON file')
         .option('--api-key <key>', 'API key')
+        .option('--format <type>', 'Output format: table, json, csv, yaml')
         .option('--json', 'JSON output')
         .action(apiAction(async (client, opts) => {
         const body = readBodyInput(opts);
@@ -91,6 +82,7 @@ export function registerBankRulesCommand(program) {
         .option('--name <name>', 'New name')
         .option('--input <file>', 'Read full update body from JSON file')
         .option('--api-key <key>', 'API key')
+        .option('--format <type>', 'Output format: table, json, csv, yaml')
         .option('--json', 'JSON output')
         .action((resourceId, opts) => apiAction(async (client) => {
         const body = readBodyInput(opts);
@@ -114,6 +106,7 @@ export function registerBankRulesCommand(program) {
         .command('delete <resourceId>')
         .description('Delete a bank rule')
         .option('--api-key <key>', 'API key')
+        .option('--format <type>', 'Output format: table, json, csv, yaml')
         .option('--json', 'JSON output')
         .action((resourceId, opts) => apiAction(async (client) => {
         await deleteBankRule(client, resourceId);

package/dist/commands/bank.js

@@ -20,6 +20,7 @@ export function registerBankCommand(program) {
         .command('accounts')
         .description('List bank accounts')
         .option('--limit <n>', 'Max results', parsePositiveInt)
+        .option('--format <type>', 'Output format: table, json, csv, yaml')
         .option('--api-key <key>', 'API key (overrides stored/env)')
         .option('--json', 'Output as JSON')
         .action(apiAction(async (client, opts) => {
@@ -40,6 +41,7 @@ export function registerBankCommand(program) {
     bank
         .command('get <resourceId>')
         .description('Get a bank account by resourceId')
+        .option('--format <type>', 'Output format: table, json, csv, yaml')
         .option('--api-key <key>', 'API key (overrides stored/env)')
         .option('--json', 'Output as JSON')
         .action((resourceId, opts) => apiAction(async (client) => {
@@ -69,6 +71,7 @@ export function registerBankCommand(program) {
         .option('--amount-min <n>', 'Filter by minimum amount', parseFloat)
         .option('--amount-max <n>', 'Filter by maximum amount', parseFloat)
         .option('--limit <n>', 'Max results (default 50)', parsePositiveInt)
+        .option('--format <type>', 'Output format: table, json, csv, yaml')
         .option('--api-key <key>', 'API key (overrides stored/env)')
         .option('--json', 'Output as JSON')
         .action((accountResourceId, opts) => apiAction(async (client) => {
@@ -112,6 +115,7 @@ export function registerBankCommand(program) {
         .command('add-records <accountResourceId>')
         .description('Add bank records via JSON (1-100 records per call)')
         .requiredOption('--records <json>', 'JSON array: [{amount, transactionDate, description?, payerOrPayee?, reference?}]')
+        .option('--format <type>', 'Output format: table, json, csv, yaml')
         .option('--api-key <key>', 'API key (overrides stored/env)')
         .option('--json', 'Output as JSON')
         .action((accountResourceId, opts) => apiAction(async (client) => {
@@ -151,6 +155,7 @@ export function registerBankCommand(program) {
         .description('Get auto-reconciliation recommendations for a bank account')
         .requiredOption('--type <type>', `Recommendation type (${RECON_TYPES.join(', ')})`)
         .option('--account <resourceId>', 'Bank account resourceId (omit for all accounts)')
+        .option('--format <type>', 'Output format: table, json, csv, yaml')
         .option('--api-key <key>', 'API key (overrides stored/env)')
         .option('--json', 'Output as JSON')
         .action(apiAction(async (client, opts) => {
@@ -202,6 +207,7 @@ export function registerBankCommand(program) {
         .description('Import a bank statement file (CSV, OFX, XLS, XLSX)')
         .requiredOption('--file <path>', 'Bank statement file path')
         .requiredOption('--account <resourceId>', 'Bank account resourceId')
+        .option('--format <type>', 'Output format: table, json, csv, yaml')
         .option('--api-key <key>', 'API key (overrides stored/env)')
         .option('--json', 'Output as JSON')
         .action(apiAction(async (client, opts) => {

package/dist/commands/bills.js

@@ -1,12 +1,20 @@
 import chalk from 'chalk';
-import { formatStatus } from './format-helpers.js';
+import { formatStatus, formatId, formatReference, formatCurrency } from './format-helpers.js';
 import { listBills, getBill, searchBills, createBill, updateBill, deleteBill, createBillPayment, applyCreditsToBill, finalizeBill, } from '../core/api/bills.js';
 import { listAttachments } from '../core/api/attachments.js';
 import { apiAction } from './api-action.js';
 import { resolveContactFlag, resolveAccountFlag, resolveTaxProfileFlag } from './resolve.js';
 import { parsePositiveInt, parseNonNegativeInt, parseMoney, parseRate, parseLineItems, parseCustomFields, readBodyInput, requireFields } from './parsers.js';
-import { paginatedFetch, paginatedJson, displaySlice } from './pagination.js';
+import { paginatedFetch } from './pagination.js';
+import { outputList } from './output.js';
 import { BILL_REQUIRED_FIELDS, buildDraftReport, formatDraftTable, addDraftFinalizeOptions, mergeDraftFlags, validateDraft, buildValidation, normalizeDate, sanitizeLineItem, } from './draft-helpers.js';
+const BILL_COLUMNS = [
+    { key: 'resourceId', header: 'ID', format: formatId },
+    { key: 'reference', header: 'Reference', format: formatReference },
+    { key: 'status', header: 'Status', format: (v) => formatStatus(String(v)) },
+    { key: 'totalAmount', header: 'Amount', align: 'right', format: formatCurrency },
+    { key: 'valueDate', header: 'Date', format: (v) => normalizeDate(String(v)) ?? '-' },
+];
 export function registerBillsCommand(program) {
     const bills = program
         .command('bills')
@@ -19,24 +27,12 @@ export function registerBillsCommand(program) {
         .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
+        .option('--format <type>', 'Output format: table, json, csv, yaml')
         .option('--api-key <key>', 'API key (overrides stored/env)')
         .option('--json', 'Output as JSON')
         .action(apiAction(async (client, opts) => {
         const result = await paginatedFetch(opts, (p) => listBills(client, p), { label: 'Fetching bills' });
-        if (opts.json) {
-            console.log(paginatedJson(result, opts));
-        }
-        else {
-            console.log(chalk.bold(`Bills (${result.data.length} of ${result.totalElements}):\n`));
-            const { items, overflow } = displaySlice(result.data);
-            for (const b of items) {
-                const amount = b.totalAmount !== undefined ? chalk.dim(` $${b.totalAmount.toFixed(2)}`) : '';
-                const status = formatStatus(b.status);
-                console.log(`  ${chalk.cyan(b.resourceId)}  ${b.reference || '(no ref)'}  ${status}${amount}  ${normalizeDate(b.valueDate)}`);
-            }
-            if (overflow > 0)
-                console.log(chalk.dim(`  ... and ${overflow.toLocaleString()} more (use --json for full output)`));
-        }
+        outputList(result, BILL_COLUMNS, opts, 'Bills'); // eslint-disable-line @typescript-eslint/no-explicit-any
     }));
     // ── clio bills get ──────────────────────────────────────────────
     bills
@@ -87,6 +83,7 @@ export function registerBillsCommand(program) {
         .option('--offset <n>', 'Page number offset (0-indexed)', parseNonNegativeInt)
         .option('--all', 'Fetch all pages')
         .option('--max-rows <n>', 'Max rows for --all (default 10000)', parsePositiveInt)
+        .option('--format <type>', 'Output format: table, json, csv, yaml')
         .option('--api-key <key>', 'API key (overrides stored/env)')
         .option('--json', 'Output as JSON')
         .action(apiAction(async (client, opts) => {
@@ -113,24 +110,7 @@ export function registerBillsCommand(program) {
         const searchFilter = Object.keys(filter).length > 0 ? filter : undefined;
         const sort = { sortBy: [opts.sort ?? 'valueDate'], order: (opts.order ?? 'DESC') };
         const result = await paginatedFetch(opts, ({ limit, offset }) => searchBills(client, { filter: searchFilter, limit, offset, sort }), { label: 'Searching bills', defaultLimit: 20 });
-        if (opts.json) {
-            console.log(paginatedJson(result, opts));
-        }
-        else {
-            if (result.data.length === 0) {
-                console.log('No bills found.');
-                return;
-            }
-            console.log(chalk.bold(`Found ${result.data.length} bill(s):\n`));
-            const { items, overflow } = displaySlice(result.data);
-            for (const b of items) {
-                const amount = b.totalAmount !== undefined ? chalk.dim(` $${b.totalAmount.toFixed(2)}`) : '';
-                const status = formatStatus(b.status);
-                console.log(`  ${chalk.cyan(b.resourceId)}  ${b.reference || '(no ref)'}  ${status}${amount}  ${normalizeDate(b.valueDate)}`);
-            }
-            if (overflow > 0)
-                console.log(chalk.dim(`  ... and ${overflow.toLocaleString()} more (use --json for full output)`));
-        }
+        outputList(result, BILL_COLUMNS, opts, 'Bills'); // eslint-disable-line @typescript-eslint/no-explicit-any
     }));
     // ── clio bills create ───────────────────────────────────────────
     bills