jaz-clio 4.2.0 → 4.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (10) hide show
  1. package/README.md +86 -251
  2. package/assets/skills/api/SKILL.md +4 -4
  3. package/assets/skills/api/references/full-api-surface.md +2 -2
  4. package/assets/skills/conversion/SKILL.md +1 -1
  5. package/assets/skills/jobs/SKILL.md +1 -1
  6. package/assets/skills/transaction-recipes/SKILL.md +1 -1
  7. package/dist/commands/init.js +1 -1
  8. package/dist/index.js +2 -2
  9. package/dist/utils/template.js +14 -4
  10. package/package.json +1 -1
package/README.md CHANGED
@@ -1,299 +1,134 @@
1
- # Jaz AI
1
+ # Clio — Jaz AI Command Line Tool
2
2
 
3
3
  <p align="center">
4
- <a href="https://github.com/teamtinvio/jaz-ai/releases"><img src="https://img.shields.io/github/v/release/teamtinvio/jaz-ai?style=for-the-badge&color=blue" alt="GitHub Release"></a>
5
- <img src="https://img.shields.io/badge/API_rules-70-green?style=for-the-badge" alt="70 API Rules">
6
- <img src="https://img.shields.io/badge/skills-4-purple?style=for-the-badge" alt="4 Skills">
7
- <img src="https://img.shields.io/badge/recipes-16-orange?style=for-the-badge" alt="16 Recipes">
4
+ <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>
5
+ <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>
8
6
  <img src="https://img.shields.io/badge/calculators-10-red?style=for-the-badge" alt="10 Calculators">
9
7
  <img src="https://img.shields.io/badge/jobs-12-teal?style=for-the-badge" alt="12 Jobs">
10
8
  <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>
11
9
  </p>
12
10
 
13
- <p align="center">
14
- <a href="https://www.npmjs.com/package/jaz-clio"><img src="https://img.shields.io/npm/v/jaz-clio?style=flat-square&logo=npm&label=CLI" alt="npm"></a>
15
- <a href="https://www.npmjs.com/package/jaz-clio"><img src="https://img.shields.io/npm/dm/jaz-clio?style=flat-square&label=downloads" alt="npm downloads"></a>
16
- <a href="https://github.com/teamtinvio/jaz-ai/stargazers"><img src="https://img.shields.io/github/stars/teamtinvio/jaz-ai?style=flat-square&logo=github" alt="GitHub stars"></a>
17
- </p>
18
-
19
- API reference, financial calculators, IFRS recipes, accounting jobs, data conversion playbooks, and tax computation — directly inside the AI that builders, accountants, and developers are already using to get things done.
20
-
21
- Agent skills for [Jaz](https://jaz.ai) accounting platform. Works with [Claude Code](https://claude.com/claude-code), [Google Antigravity](https://antigravity.google), [OpenAI Codex](https://openai.com/codex), [GitHub Copilot](https://github.com/features/copilot), [Cursor](https://cursor.com), and any tool that supports the [Agent Skills](https://agentskills.io) open standard.
22
-
23
- > All skills, CLI commands, and the plugin are fully compatible with [Juan Accounting](https://juan.ac) too.
24
-
25
- ## Skills
26
-
27
- | Skill | What It Does |
28
- |-------|-------------|
29
- | **jaz-api** | 70 rules, full endpoint catalog, error catalog, field mapping. Agents write correct Jaz API code on the first try instead of guessing |
30
- | **jaz-conversion** | Xero, QuickBooks, Sage, Excel migration playbook. CoA mapping, tax profiles, FX, clearing accounts, trial balance verification |
31
- | **jaz-recipes** | 16 IFRS-compliant recipes (loans, leases, depreciation, FX reval, ECL, provisions, and more) + 10 CLI financial calculators with blueprint output |
32
- | **jaz-jobs** | 12 accounting jobs (month/quarter/year-end close, bank recon, document collection, GST/VAT filing, payment runs, credit control, supplier recon, audit prep, FA review, statutory filing) + Singapore Form C-S tax computation with AI-guided wizard workflow |
11
+ 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.
33
12
 
34
- ## Installation
13
+ > Also fully compatible with [Juan Accounting](https://juan.ac).
35
14
 
36
- ### Using Clio CLI (Recommended)
37
-
38
- Works with any AI tool. Auto-detects your platform and installs to the right path.
15
+ ## Install
39
16
 
40
17
  ```bash
41
- # Install CLI globally
42
18
  npm install -g jaz-clio
43
-
44
- # Go to your project
45
- cd /path/to/your/project
46
-
47
- # Install all skills (auto-detects platform)
48
- clio init
49
-
50
- # Or install a specific skill
51
- clio init --skill jaz-api
52
- clio init --skill jaz-conversion
53
- clio init --skill jaz-recipes
54
- clio init --skill jaz-jobs
55
-
56
- # Force a specific platform
57
- clio init --platform claude # → .claude/skills/
58
- clio init --platform antigravity # → .agents/skills/
59
- clio init --platform codex # → .agents/skills/
60
- clio init --platform agents # → .agents/skills/ (universal)
61
19
  ```
62
20
 
63
- ### Claude Code Marketplace
21
+ ## Authenticate
64
22
 
65
- ```
66
- /plugin marketplace add teamtinvio/jaz-ai
67
- /plugin install jaz-ai@jaz-plugins
68
- ```
23
+ ```bash
24
+ # Add your Jaz API key (get one from Settings > API in the Jaz app)
25
+ clio auth add <your-api-key>
69
26
 
70
- ### OpenAI Codex
27
+ # Verify it works
28
+ clio auth whoami
71
29
 
72
- ```
73
- $skill-installer https://github.com/teamtinvio/jaz-ai
30
+ # Manage multiple orgs
31
+ clio auth add <another-key> # Adds a second profile
32
+ clio auth list # See all profiles
33
+ clio auth switch <label> # Switch active org
74
34
  ```
75
35
 
76
- ### Manual Install
36
+ ## Commands
77
37
 
78
- Copy the skill directories into your project:
38
+ ### Transactions
79
39
 
80
40
  ```bash
81
- # For Antigravity, Codex, Copilot, Cursor (Agent Skills standard)
82
- cp -r .agents/skills/ /path/to/your/project/.agents/skills/
83
-
84
- # For Claude Code
85
- cp -r .claude/skills/ /path/to/your/project/.claude/skills/
41
+ clio invoices list # List invoices
42
+ clio invoices create --contact "ACME" # Create a draft invoice
43
+ clio invoices pay <id> # Record payment
44
+ clio bills list --status APPROVED # List approved bills
45
+ clio bills pay <id> # Pay a bill
46
+ clio customer-credit-notes list # List customer credit notes
47
+ clio supplier-credit-notes list # List supplier credit notes
48
+ clio journals list # List journal entries
49
+ clio cash-in list # List cash-in entries
50
+ clio cash-out list # List cash-out entries
51
+ clio cash-transfer list # List cash transfers
86
52
  ```
87
53
 
88
- ### Other CLI Commands
54
+ ### Contacts, Accounts & Items
89
55
 
90
56
  ```bash
91
- clio versions # List available versions
92
- clio update # Update to latest version
93
- clio --help # Show all commands
94
- ```
95
-
96
- ## Usage
97
-
98
- Skills activate automatically when you or your agent work with Jaz API code or data conversion tasks. Just describe what you need:
99
-
100
- ### API Skill
101
-
57
+ clio contacts search "ACME" # Fuzzy search contacts
58
+ clio contacts create --name "ACME Ltd" # Create a contact
59
+ clio accounts list # Chart of accounts
60
+ clio items list # Products and services
61
+ clio tags list # Tracking tags
102
62
  ```
103
- Create an invoice with 3 line items and 7% GST
104
-
105
- Build a payment for invoice INV-001 in USD
106
63
 
107
- Query all overdue bills with pagination
64
+ ### Financial Calculators
108
65
 
109
- Set up chart of accounts for a Singapore company
110
- ```
111
-
112
- ### Conversion Skill
113
-
114
- ```
115
- Convert this Xero trial balance export to Jaz
116
-
117
- Migrate QuickBooks aged receivables to conversion invoices
118
-
119
- Map this Excel chart of accounts to Jaz CoA structure
120
-
121
- Verify the trial balance after conversion
122
- ```
123
-
124
- ### Transaction Recipes Skill
66
+ 10 IFRS-compliant calculators that output structured blueprints with journal entries, workings, and execution plans.
125
67
 
68
+ ```bash
69
+ clio calc loan --principal 100000 --rate 6 --term 60 --json
70
+ clio calc depreciation --cost 50000 --salvage 5000 --life 5 --method ddb --json
71
+ clio calc lease --value 120000 --term 36 --rate 5 --json
72
+ clio calc ecl --receivables '[{"bucket":"0-30","balance":50000,"rate":0.5}]' --json
73
+ clio calc provision --amount 100000 --rate 4 --periods 24 --json
74
+ clio calc fx-reval --account "USD Cash" --balance 10000 --old-rate 1.35 --new-rate 1.34 --json
75
+ clio calc fixed-deposit --principal 100000 --rate 3.5 --term 12 --json
76
+ clio calc disposal --cost 50000 --accum-dep 30000 --proceeds 15000 --json
77
+ clio calc amortization --amount 12000 --periods 12 --start 2025-01-01 --json
78
+ clio calc hire-purchase --value 80000 --term 48 --rate 4.5 --json
126
79
  ```
127
- Set up a 5-year bank loan with monthly repayment schedule
128
-
129
- Model IFRS 16 lease for a 3-year office lease at 5% IBR
130
80
 
131
- Calculate ECL provision on aged receivables
81
+ ### Accounting Jobs
132
82
 
133
- Record prepaid insurance with monthly amortization via capsule
134
- ```
83
+ 12 job blueprints that generate step-by-step playbooks with checklists and paired tools.
135
84
 
136
- ### Jobs Skill
85
+ ```bash
86
+ clio jobs month-end --period 2025-01 # Month-end close
87
+ clio jobs quarter-end --period 2025-Q1 # Quarter-end close
88
+ clio jobs year-end --period 2025 # Year-end close
89
+ clio jobs bank-recon match --input bank-data.json --json # Bank reconciliation matcher
90
+ clio jobs document-collection ingest --source "./receipts" --json # Document scanner
91
+ clio jobs gst-vat --period 2025-Q1 # GST/VAT filing prep
92
+ clio jobs payment-run --due-before 2025-02-28 # Payment run
93
+ clio jobs credit-control # AR aging + chase list
94
+ clio jobs supplier-recon # AP vs supplier statements
95
+ clio jobs audit-prep --period 2025 # Audit pack
96
+ clio jobs fa-review # Fixed asset review
97
+ clio jobs statutory-filing sg-cs --ya 2026 --revenue 500000 --profit 120000 --json # SG Form C-S
98
+ ```
99
+
100
+ ### Other
137
101
 
102
+ ```bash
103
+ clio org info # Current org details
104
+ clio currencies list # Enabled currencies
105
+ clio currency-rates list # Exchange rates
106
+ clio payments search # Search payments
107
+ clio bank import --file statement.csv # Import bank statement
108
+ clio reports generate --type pnl # Generate reports
109
+ clio capsules list # List capsules (transaction groups)
110
+ clio versions # Show version info
111
+ clio update # Update to latest
138
112
  ```
139
- Close the books for January 2025
140
113
 
141
- Run bank reconciliation for DBS Current account
114
+ Every command supports `--json` for structured output — ideal for piping to other tools or for AI agents.
142
115
 
143
- Prepare GST return for Q1 2025
144
-
145
- Generate a payment run for all overdue bills
146
-
147
- Prepare audit pack for FY 2025
148
- ```
116
+ ## Install AI Skills
149
117
 
150
- ### Financial Calculators & Job Tools (CLI)
118
+ Clio also installs AI agent skills into your project. Skills are knowledge files that teach AI tools (Claude Code, Antigravity, Codex, Copilot, Cursor) how to work with the Jaz API.
151
119
 
152
120
  ```bash
153
- clio calc loan --principal 100000 --rate 6 --term 60 --json
154
- clio calc depreciation --cost 50000 --salvage 5000 --life 5 --method ddb --json
155
- clio jobs bank-recon match --input bank-data.json --json
156
- clio jobs document-collection ingest --source "https://www.dropbox.com/scl/fo/..." --json
157
- clio jobs statutory-filing sg-cs --ya 2026 --revenue 500000 --profit 120000 --json
121
+ cd /path/to/your/project
122
+ clio init # Auto-detects your AI tool, installs all 4 skills
123
+ clio init --skill jaz-api # Install a specific skill
124
+ clio init --platform claude # Force a specific platform
158
125
  ```
159
126
 
160
- 10 financial calculators, 12 job blueprints, and paired tools (bank matcher, document ingest with cloud support, SG Form C-S tax computation). Add `--json` for structured blueprint output with capsule type, journal entries, workings, and step-by-step execution plan.
161
-
162
- Full command reference: [transaction-recipes skill](src/skills/transaction-recipes/SKILL.md) and [jobs skill](src/skills/jobs/SKILL.md).
163
-
164
- ## What's Inside
165
-
166
- ### API Skill (`jaz-api`)
167
-
168
- | Reference | Lines | Content |
169
- |-----------|-------|---------|
170
- | `SKILL.md` | 185 | 70 critical rules — auth, IDs, dates, FX, payments, field aliases, response shapes |
171
- | `endpoints.md` | 1,299 | Request/response examples for every core endpoint |
172
- | `errors.md` | 751 | Error catalog with root causes and fixes |
173
- | `field-map.md` | 428 | Intuitive name -> actual field name mapping |
174
- | `search-reference.md` | 714 | Filter fields, sort fields, operators for 28 search endpoints |
175
- | `full-api-surface.md` | 699 | Complete endpoint catalog (80+), enums, limits |
176
- | `dependencies.md` | 139 | Resource creation order (currencies -> CoA -> transactions) |
177
- | `feature-glossary.md` | 216 | Business context per feature |
178
-
179
- ### Conversion Skill (`jaz-conversion`)
180
-
181
- | Reference | Content |
182
- |-----------|---------|
183
- | `SKILL.md` | Conversion domain knowledge, clearing account pattern, FX handling |
184
- | `mapping-rules.md` | CoA, contact, and tax code mapping rules |
185
- | `option1-full.md` | Full conversion workflow (all transactions FY + FY-1) |
186
- | `option2-quick.md` | Quick conversion workflow (opening balances at FYE) |
187
- | `file-types.md` | Supported file formats and detection heuristics |
188
- | `edge-cases.md` | Platform-specific quirks (Sage 300 preambles, Xero rounding) |
189
- | `verification.md` | Trial balance comparison and verification checklist |
190
- | `file-analysis.md` | Excel/CSV structure analysis and smart detection |
191
-
192
- ### Transaction Recipes Skill (`jaz-recipes`)
193
-
194
- | Reference | Content |
195
- |-----------|---------|
196
- | `SKILL.md` | 16 recipes in 4 tiers, building blocks, key principles, calculator index |
197
- | `building-blocks.md` | Capsules, schedulers, manual journals, FA, tracking tags, nano classifiers |
198
- | `prepaid-amortization.md` | Annual insurance/rent paid upfront, monthly scheduler recognition |
199
- | `deferred-revenue.md` | Upfront customer payment, monthly revenue recognition |
200
- | `accrued-expenses.md` | Month-end accrual + reversal cycle using dual schedulers |
201
- | `bank-loan.md` | Loan disbursement, amortization table, monthly installments |
202
- | `ifrs16-lease.md` | ROU asset + lease liability unwinding (IFRS 16) |
203
- | `declining-balance.md` | DDB/150DB with switch-to-SL logic |
204
- | `fixed-deposit.md` | Placement, compound interest accrual, maturity (IFRS 9) |
205
- | `hire-purchase.md` | Like IFRS 16 but depreciate over useful life |
206
- | `asset-disposal.md` | Sale/scrap/write-off with gain/loss (IAS 16) |
207
- | `fx-revaluation.md` | Non-AR/AP FX revaluation with Day 1 reversal (IAS 21) |
208
- | `bad-debt-provision.md` | ECL simplified approach provision matrix (IFRS 9) |
209
- | `employee-accruals.md` | Leave (scheduler) + bonus (manual) accruals (IAS 19) |
210
- | `provisions.md` | PV recognition + monthly discount unwinding (IAS 37) |
211
- | `dividend.md` | Declaration + payment (two manual journals) |
212
- | `intercompany.md` | Mirrored invoices/bills across two entities |
213
- | `capital-wip.md` | CIP accumulation → FA transfer on completion |
214
-
215
-
216
- ### Jobs Skill (`jaz-jobs`)
217
-
218
- | Reference | Content |
219
- |-----------|---------|
220
- | `SKILL.md` | 12 accounting jobs + SG tax computation, CLI commands, wizard workflow overview |
221
- | `building-blocks.md` | Shared concepts: accounting periods, lock dates, period verification |
222
- | `month-end-close.md` | 5 phases, ~18 steps — the foundation for all period closes |
223
- | `quarter-end-close.md` | Monthly + quarterly extras (GST/VAT, ECL, bonus accruals) |
224
- | `year-end-close.md` | Quarterly + annual extras (true-ups, dividends, CYE rollover) |
225
- | `bank-recon.md` | Match, categorize, resolve unreconciled items |
226
- | `bank-match.md` | Bank reconciliation matcher — 5-phase cascade algorithm (1:1, N:1, 1:N, N:M) |
227
- | `document-collection.md` | Scan and classify documents from local directories and cloud links (Dropbox, Google Drive, OneDrive) — outputs file paths for agent upload |
228
- | `gst-vat-filing.md` | Tax ledger review, discrepancy check, filing summary |
229
- | `payment-run.md` | Select outstanding bills by due date, process payments |
230
- | `credit-control.md` | AR aging review, overdue chase list, bad debt assessment |
231
- | `supplier-recon.md` | AP vs supplier statement, identify mismatches |
232
- | `audit-prep.md` | Compile reports, schedules, reconciliations for auditor |
233
- | `fa-review.md` | Fixed asset register review, disposal/write-off processing |
234
- | `sg-tax/overview.md` | SG CIT framework: 17% rate, YA concept, Form C-S eligibility |
235
- | `sg-tax/form-cs-fields.md` | 18 Form C-S + 6 C-S Lite fields with IRAS labels |
236
- | `sg-tax/wizard-workflow.md` | Step-by-step AI agent wizard procedure |
237
- | `sg-tax/data-extraction.md` | How to pull P&L, TB, GL, FA from Jaz API for tax |
238
- | `sg-tax/add-backs-guide.md` | Which expenses are non-deductible + GL patterns |
239
- | `sg-tax/capital-allowances-guide.md` | S19, S19A, S19B, S14Q rules per asset category |
240
- | `sg-tax/ifrs16-tax-adjustment.md` | IFRS 16 lease reversal for tax purposes |
241
- | `sg-tax/enhanced-deductions.md` | R&D (250-400%), IP, donations (250% IPC), S14Q |
242
- | `sg-tax/exemptions-and-rebates.md` | SUTE, PTE, CIT rebate schedule by YA |
243
- | `sg-tax/losses-and-carry-forwards.md` | Set-off order, carry-forward rules |
244
-
245
- ## Architecture
246
-
247
- ```
248
- .claude-plugin/ Claude Code marketplace manifest
249
- ├── plugin.json
250
- └── marketplace.json
251
-
252
- .agents/skills/ Agent Skills standard (Codex, Copilot, Cursor)
253
- ├── api/ → src/skills/api/
254
- ├── conversion/ → src/skills/conversion/
255
- ├── transaction-recipes/ → src/skills/transaction-recipes/
256
- └── jobs/ → src/skills/jobs/
257
-
258
- .claude/skills/ Claude Code native path
259
- ├── api/ → src/skills/api/
260
- ├── conversion/ → src/skills/conversion/
261
- ├── transaction-recipes/ → src/skills/transaction-recipes/
262
- └── jobs/ → src/skills/jobs/
263
-
264
- src/skills/ Source of truth (single copy, dual discovery paths)
265
- ├── api/ 70 rules + 7 reference files
266
- ├── conversion/ Conversion domain + 7 reference files
267
- ├── transaction-recipes/ 16 recipes + 18 reference files
268
- └── jobs/ 12 jobs + 12 job files + 10 sg-tax files
269
-
270
- src/ npm CLI (jaz-clio)
271
- ├── commands/ CLI command handlers (23 command groups)
272
- │ ├── calc.ts 10 financial calculator commands
273
- │ ├── jobs.ts Job blueprints + nested tools
274
- │ ├── invoices.ts Invoice CRUD + pay + apply-credits + download
275
- │ ├── bills.ts Bill CRUD + pay + apply-credits
276
- │ ├── customer-credit-notes.ts CCN CRUD + refund + refunds (list)
277
- │ ├── supplier-credit-notes.ts SCN CRUD + refund + refunds (list)
278
- │ ├── contacts.ts Contact CRUD + search
279
- │ ├── journals.ts Journal entries + search
280
- │ ├── cash-entry.ts Cash-in / cash-out journals
281
- │ ├── cash-transfer.ts Cash transfer journals
282
- │ ├── currencies.ts Currency list + enable
283
- │ ├── currency-rates.ts Exchange rate CRUD
284
- │ └── ... 10 more (auth, org, bank, accounts, reports, etc.)
285
- ├── core/ Shared logic
286
- │ ├── api/ Jaz REST client (30+ modules, 70+ endpoints)
287
- │ ├── calc/ 10 financial calculators
288
- │ ├── jobs/ 12 job blueprints + paired tools
289
- │ ├── auth/ Credential management
290
- │ └── intelligence/ Fuzzy matching, date parsing, contact resolution
291
- └── assets/skills/ Bundled skill content for npm package
292
- ```
127
+ See the [full README](https://github.com/teamtinvio/jaz-ai) for skill details, reference file catalogs, and plugin installation.
293
128
 
294
129
  ## Common API Gotchas
295
130
 
296
- Mistakes the skill prevents — for agents and humans alike:
131
+ Mistakes the CLI and skills prevent:
297
132
 
298
133
  | Gotcha | Wrong | Right |
299
134
  |--------|-------|-------|
@@ -308,4 +143,4 @@ Mistakes the skill prevents — for agents and humans alike:
308
143
 
309
144
  ## License
310
145
 
311
- [MIT](LICENSE) - Copyright (c) 2026 Tinvio / Jaz
146
+ [MIT](https://github.com/teamtinvio/jaz-ai/blob/main/LICENSE) - Copyright (c) 2026 Tinvio / Jaz
package/assets/skills/api/SKILL.md CHANGED
@@ -1,14 +1,14 @@
1
1
  ---
2
2
  name: jaz-api
3
- version: 4.2.0
4
- description: Complete reference for the Jaz/Juan 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.
3
+ version: 4.2.1
4
+ 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.
5
5
  license: MIT
6
- compatibility: Requires Jaz/Juan API key (x-jk-api-key header). Works with Claude Code, Claude Cowork, Claude.ai, and any agent that reads markdown.
6
+ 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.
7
7
  ---
8
8
 
9
9
  # Jaz API Skill
10
10
 
11
- You are working with the **Jaz/Juan REST API** — the backend for Jaz (Singapore) and Juan (Philippines) accounting platforms.
11
+ You are working with the **Jaz REST API** — the accounting platform backend. Also fully compatible with Juan Accounting (same API, same endpoints).
12
12
 
13
13
  ## When to Use This Skill
14
14
 
package/assets/skills/api/references/full-api-surface.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Jaz API — Complete Endpoint Catalog
2
2
 
3
- > Every endpoint in the Jaz/Juan REST API, organized by resource. Includes undocumented
3
+ > Every endpoint in the Jaz REST API, organized by resource. Includes undocumented
4
4
  > endpoints, magic AI features, admin APIs, and advanced search/filter syntax.
5
5
  > For request/response examples of core endpoints, see endpoints.md.
6
6
 
@@ -655,7 +655,7 @@ DEBT_WRITE_OFF, INTER_COMPANY, OTHER, PAYMENT_GATEWAY
655
655
 
656
656
  ## Platform Features Affecting API Behavior
657
657
 
658
- These features exist in the Jaz/Juan platform and may affect API responses or cause unexpected errors.
658
+ These features exist in the Jaz platform and may affect API responses or cause unexpected errors.
659
659
 
660
660
  ### Approvals
661
661
  - Bills and invoices can be submitted for approval workflow
package/assets/skills/conversion/SKILL.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: jaz-conversion
3
- version: 4.2.0
3
+ version: 4.2.1
4
4
  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.
5
5
  ---
6
6
 
package/assets/skills/jobs/SKILL.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: jaz-jobs
3
- version: 4.2.0
3
+ version: 4.2.1
4
4
  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).
5
5
  license: MIT
6
6
  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 CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: jaz-recipes
3
- version: 4.2.0
3
+ version: 4.2.1
4
4
  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 10 financial calculators that produce execution-ready blueprints with workings.
5
5
  license: MIT
6
6
  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/init.js CHANGED
@@ -73,7 +73,7 @@ export async function initCommand(options) {
73
73
  logger.success('Clio — Jaz AI skills installed successfully!');
74
74
  console.log();
75
75
  console.log(chalk.bold('Next steps:'));
76
- console.log(chalk.dim(' 1. Restart your AI tool (Claude Code, Antigravity, Codex, Copilot, etc.)'));
76
+ console.log(chalk.dim(' 1. Restart your AI tool (Claude Code, Antigravity, Codex, Copilot, Cursor, etc.)'));
77
77
  console.log(chalk.dim(' 2. Try: "Create an invoice with line items and tax"'));
78
78
  if (skillType === 'all' || skillType === 'jaz-conversion') {
79
79
  console.log(chalk.dim(' 3. Try: "Convert this Xero trial balance to Jaz"'));
package/dist/index.js CHANGED
@@ -55,14 +55,14 @@ program
55
55
  .description('Install Jaz AI skills into the current project')
56
56
  .option('-s, --skill <type>', `Skill to install (${SKILL_TYPES.join(', ')})`)
57
57
  .option('-f, --force', 'Overwrite existing files')
58
- .option('-p, --platform <type>', 'Target platform: claude, antigravity, codex, agents, auto (default: auto-detect)')
58
+ .option('-p, --platform <type>', 'Target platform: claude, codex, copilot, cursor, antigravity, windsurf, goose, gemini, agents, auto (default: auto-detect)')
59
59
  .action(async (options) => {
60
60
  if (options.skill && !SKILL_TYPES.includes(options.skill)) {
61
61
  console.error(`Invalid skill type: ${options.skill}`);
62
62
  console.error(`Valid types: ${SKILL_TYPES.join(', ')}`);
63
63
  process.exit(1);
64
64
  }
65
- const validPlatforms = ['claude', 'antigravity', 'codex', 'agents', 'auto'];
65
+ const validPlatforms = ['claude', 'antigravity', 'codex', 'copilot', 'cursor', 'windsurf', 'goose', 'gemini', 'agents', 'auto'];
66
66
  if (options.platform && !validPlatforms.includes(options.platform)) {
67
67
  console.error(`Invalid platform: ${options.platform}`);
68
68
  console.error(`Valid platforms: ${validPlatforms.join(', ')}`);
package/dist/utils/template.js CHANGED
@@ -39,6 +39,14 @@ export async function detectPlatform(projectDir) {
39
39
  return 'agents';
40
40
  if (await exists(join(projectDir, '.antigravity')))
41
41
  return 'agents';
42
+ if (await exists(join(projectDir, '.cursor')))
43
+ return 'agents';
44
+ if (await exists(join(projectDir, '.copilot')))
45
+ return 'agents';
46
+ if (await exists(join(projectDir, '.windsurf')))
47
+ return 'agents';
48
+ if (await exists(join(projectDir, '.goose')))
49
+ return 'agents';
42
50
  // Check for platform-specific instruction files
43
51
  if (await exists(join(projectDir, 'CLAUDE.md')))
44
52
  return 'claude';
@@ -80,10 +88,12 @@ async function installSkill(targetDir, skillName, force, platform) {
80
88
  * Install selected skills into the target project.
81
89
  */
82
90
  export async function installSkills(targetDir, skillType, force = false, platform = 'auto') {
83
- // Resolve platform
84
- const resolvedPlatform = platform === 'auto' || platform === 'codex' || platform === 'antigravity'
85
- ? (platform === 'codex' || platform === 'antigravity' ? 'agents' : await detectPlatform(targetDir))
86
- : platform;
91
+ // Resolve platform — all non-Claude platforms map to Agent Skills standard (.agents/skills/)
92
+ const resolvedPlatform = platform === 'claude'
93
+ ? 'claude'
94
+ : platform === 'auto'
95
+ ? await detectPlatform(targetDir)
96
+ : 'agents';
87
97
  const skillsToInstall = skillType === 'all' ? SKILLS : [skillType];
88
98
  const installedPaths = [];
89
99
  for (const skill of skillsToInstall) {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "jaz-clio",
3
- "version": "4.2.0",
3
+ "version": "4.2.1",
4
4
  "description": "Clio — Command Line Interface Orchestrator for Jaz AI.",
5
5
  "type": "module",
6
6
  "bin": {