hzl-cli 1.25.2 → 1.26.0

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 +42 -11
  2. package/package.json +3 -3
package/README.md CHANGED
@@ -121,24 +121,55 @@ HZL includes a basic [Kanban dashboard](#web-dashboard) for human visibility. Fo
121
121
 
122
122
  ## Quickstart
123
123
 
124
- ### Install
124
+ ### 1. Install HZL
125
125
 
126
126
  Requires Node.js 22.14+.
127
127
 
128
- #### Via Homebrew (macOS/Linux)
128
+ ```bash
129
+ curl -fsSL "https://raw.githubusercontent.com/tmchow/hzl/main/scripts/install.sh?$(date +%s)" | bash
130
+ ```
131
+
132
+ This installs the CLI, initializes the database, and sets up Claude Code/Codex integrations (if detected).
133
+
134
+ <details>
135
+ <summary>Alternative install methods</summary>
136
+
137
+ **Via Homebrew (macOS/Linux):**
138
+ ```bash
139
+ brew tap tmchow/hzl && brew install hzl && hzl init
140
+ ```
129
141
 
142
+ **Via NPM:**
130
143
  ```bash
131
- brew tap tmchow/hzl
132
- brew install hzl
144
+ npm install -g hzl-cli && hzl init
133
145
  ```
134
146
 
135
- #### Via NPM
147
+ **Then set up agent integrations:**
136
148
 
149
+ *Claude Code (run in Claude Code):*
150
+ ```
151
+ /plugin marketplace add tmchow/hzl
152
+ /plugin install hzl@hzl
153
+ ```
154
+
155
+ *Codex:*
137
156
  ```bash
138
- npm install -g hzl-cli
139
- hzl init
157
+ mkdir -p ~/.codex/skills/hzl
158
+ curl -fsSL https://raw.githubusercontent.com/tmchow/hzl/main/skills/hzl/SKILL.md -o ~/.codex/skills/hzl/SKILL.md
140
159
  ```
141
160
 
161
+ </details>
162
+
163
+ ### 2. Add HZL to your project
164
+
165
+ Run this in your repo to append the agent policy to your AGENTS.md (or CLAUDE.md, GEMINI.md):
166
+
167
+ ```bash
168
+ curl -fsSL https://raw.githubusercontent.com/tmchow/hzl/main/snippets/AGENT-POLICY.md >> AGENTS.md
169
+ ```
170
+
171
+ This teaches your coding agent when to use HZL.
172
+
142
173
  ### Enable Cloud Sync (Optional)
143
174
 
144
175
  Sync with a Turso database for multi-device/multi-agent access:
@@ -446,7 +477,7 @@ Copy/paste this into an OpenClaw chat (single prompt):
446
477
  <!-- START [code:txt] snippets/OPENCLAW-SETUP-PROMPT.md -->
447
478
  <!-- ⚠️ DO NOT EDIT - Auto-generated from snippets/OPENCLAW-SETUP-PROMPT.md -->
448
479
  ````txt
449
- Install HZL from https://github.com/tmchow/hzl and run hzl init. Install the HZL skill from https://www.clawhub.ai/tmchow/hzl. Then append the HZL policy from https://raw.githubusercontent.com/tmchow/hzl/main/docs/openclaw/tools-prompt.md to my TOOLS.md.
480
+ Install HZL from https://github.com/tmchow/hzl and run hzl init. Install the HZL skill from https://www.clawhub.ai/tmchow/hzl. Then append the HZL policy from https://raw.githubusercontent.com/tmchow/hzl/main/openclaw/OPENCLAW-TOOLS-PROMPT.md to my TOOLS.md.
450
481
  ````
451
482
  <!-- END [code:txt] snippets/OPENCLAW-SETUP-PROMPT.md -->
452
483
 
@@ -460,15 +491,15 @@ hzl init
460
491
  ```
461
492
 
462
493
  2) Install the HZL skill from https://www.clawhub.ai/tmchow/hzl
463
- Skill source (for reference only): **[`docs/openclaw/skill-hzl.md`](./docs/openclaw/skill-hzl.md)**
494
+ Skill source (for reference only): **[`openclaw/skills/hzl/SKILL.md`](./openclaw/skills/hzl/SKILL.md)**
464
495
 
465
496
  3) Teach OpenClaw when to use HZL (important):
466
- - Copy/paste from: **[`docs/openclaw/tools-prompt.md`](./docs/openclaw/tools-prompt.md)**
497
+ - Copy/paste from: **[`openclaw/OPENCLAW-TOOLS-PROMPT.md`](./openclaw/OPENCLAW-TOOLS-PROMPT.md)**
467
498
  - Or tell OpenClaw to add this policy to `TOOLS.md`:
468
499
 
469
500
  ```
470
501
  HZL is a tool available to you for task management in certain cases. I want you to add this information to your TOOLS.md in the right way so you remember how to use it:
471
- https://raw.githubusercontent.com/tmchow/hzl/main/docs/openclaw/tools-prompt.md
502
+ https://raw.githubusercontent.com/tmchow/hzl/main/openclaw/OPENCLAW-TOOLS-PROMPT.md
472
503
  ```
473
504
 
474
505
  ### Upgrading HZL
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "hzl-cli",
3
- "version": "1.25.2",
3
+ "version": "1.26.0",
4
4
  "description": "CLI for HZL - External task ledger for coding agents and OpenClaw.",
5
5
  "type": "module",
6
6
  "bin": {
@@ -60,8 +60,8 @@
60
60
  "libsql": "^0.5.0",
61
61
  "commander": "^14.0.0",
62
62
  "zod": "^3.23.8",
63
- "hzl-core": "1.25.2",
64
- "hzl-web": "1.25.2"
63
+ "hzl-core": "1.26.0",
64
+ "hzl-web": "1.26.0"
65
65
  },
66
66
  "devDependencies": {
67
67
  "@types/better-sqlite3": "^7.6.13",