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.
- package/README.md +42 -11
- 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
|
-
|
|
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
|
-
|
|
132
|
-
brew install hzl
|
|
144
|
+
npm install -g hzl-cli && hzl init
|
|
133
145
|
```
|
|
134
146
|
|
|
135
|
-
|
|
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
|
-
|
|
139
|
-
hzl
|
|
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/
|
|
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): **[`
|
|
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: **[`
|
|
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/
|
|
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.
|
|
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.
|
|
64
|
-
"hzl-web": "1.
|
|
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",
|