@centry-digital/bukku-cli 2.0.3 → 2.0.4

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 (2) hide show
  1. package/README.md +23 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -70,6 +70,29 @@ bukku config show
70
70
 
71
71
  This shows the resolved value for each field and where it came from (flag, environment variable, or config file).
72
72
 
73
+ ## Using with AI Tools
74
+
75
+ The CLI works great as a tool for AI assistants. Since it outputs structured JSON by default and writes errors to stderr, AI tools can parse the output directly.
76
+
77
+ ### Claude Code
78
+
79
+ First, configure your credentials:
80
+
81
+ ```bash
82
+ bukku config set api_token your-token-here
83
+ bukku config set company_subdomain your-subdomain
84
+ ```
85
+
86
+ Then ask Claude Code to use the CLI. For example:
87
+
88
+ - "Use `bukku` to list my unpaid invoices"
89
+ - "Create a sales invoice for RM 5,000 to contact 123 using `bukku`"
90
+ - "Show me last month's bank transactions with `bukku`"
91
+
92
+ Claude Code can run `bukku` commands via its Bash tool, read the JSON output, and take follow-up actions.
93
+
94
+ > **Tip:** For AI-assisted accounting with richer integration, see also [@centry-digital/bukku-mcp](https://www.npmjs.com/package/@centry-digital/bukku-mcp) — an MCP server that exposes Bukku as native AI tools.
95
+
73
96
  ## Usage Examples
74
97
 
75
98
  ### Sales
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@centry-digital/bukku-cli",
3
- "version": "2.0.3",
3
+ "version": "2.0.4",
4
4
  "description": "Bukku accounting CLI - manage invoices, contacts, and accounting from the command line",
5
5
  "type": "module",
6
6
  "main": "build/index.js",