docket-agent 0.2.0 → 0.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 (3) hide show
  1. package/README.md +46 -2
  2. package/package.json +1 -1
  3. package/src/cli.js +1 -1
package/README.md CHANGED
@@ -7,7 +7,10 @@
7
7
  Before your agent acts, it checks a one-page rule file you wrote: allow, ask,
8
8
  or deny. After, it leaves a tamper-evident record. Anything you didn't write
9
9
  down, the agent must ask about. Plain Markdown in your repo; works with
10
- Claude, Codex, Cursor, and any MCP client.
10
+ Claude, ChatGPT/Codex, Gemini, Cursor, OpenClaw, Hermes, and any MCP client.
11
+
12
+ **Install:** `npm install -g docket-agent` · **Docs:**
13
+ [shahcolate.github.io/docket/docs.html](https://shahcolate.github.io/docket/docs.html)
11
14
 
12
15
  Zero dependencies · plain Markdown + JSONL · MIT
13
16
 
@@ -202,6 +205,47 @@ The agent gets four tools:
202
205
  Warrant checks made by the agent land in the record too. *"Did the agent
203
206
  even ask?"* becomes a grep.
204
207
 
208
+ ## OpenClaw and Hermes
209
+
210
+ **[OpenClaw](https://docs.openclaw.ai)** injects your workspace's `AGENTS.md`
211
+ into the agent's system prompt at the start of every session — so compile
212
+ straight into the workspace (fitting, given the story that opens this README):
213
+
214
+ ```console
215
+ $ cd ~/.openclaw/workspace
216
+ $ npx docket-agent init
217
+ $ npx docket-agent new followup --template client-follow-up
218
+ $ npx docket-agent compile --target agents --write
219
+ ```
220
+
221
+ Docket only manages its own marked block inside `AGENTS.md` — your existing
222
+ rules, `SOUL.md`, and the rest of the workspace stay untouched. OpenClaw can
223
+ also run the MCP server for native checks and record entries: add `docket`
224
+ as an MCP server in your OpenClaw config with
225
+ `command: npx, args: ["-y", "docket-agent", "mcp", "--dir", "~/.openclaw/workspace"]`.
226
+
227
+ **[Hermes](https://hermes-agent.nousresearch.com/docs/)** (Nous Research)
228
+ reads `AGENTS.md` context files too — run the same three commands in the
229
+ directory Hermes works from. For native tools, add docket under the MCP
230
+ servers section of `~/.hermes/config.yaml`:
231
+
232
+ ```yaml
233
+ docket:
234
+ command: npx
235
+ args: ["-y", "docket-agent", "mcp", "--dir", "/path/to/your/project"]
236
+ ```
237
+
238
+ Any other agent that reads `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, or speaks
239
+ MCP gets the same treatment — one loop file, every agent under the same
240
+ warrant.
241
+
242
+ ## Documentation
243
+
244
+ The full guide — concepts, loop-file reference, the verdict algorithm,
245
+ matching semantics, record internals, CLI reference, and per-tool setup —
246
+ lives at **[the docs site](https://shahcolate.github.io/docket/docs.html)**.
247
+ The normative format definition is the [Loop File Spec](spec/SPEC.md).
248
+
205
249
  ## Five questions, then the loop exists
206
250
 
207
251
  `docket new <name>` interviews you:
@@ -275,7 +319,7 @@ Read the [Loop File Spec](spec/SPEC.md) — it's short on purpose.
275
319
  - [ ] `docket check` as a Claude Code PreToolUse hook recipe
276
320
  - [ ] Loop inheritance (`extends:`) for team baselines
277
321
  - [ ] Record export → human-readable work summaries
278
- - [ ] Adapters: OpenAI custom instructions, Gemini, Windsurf
322
+ - [ ] Adapters: OpenAI custom instructions, Windsurf
279
323
 
280
324
  ## Contributing
281
325
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "docket-agent",
3
- "version": "0.2.0",
3
+ "version": "0.2.1",
4
4
  "description": "The permission layer and paper trail for AI agents. Your agent checks a rule file before it acts - allow, ask, or deny - and leaves a tamper-evident record after.",
5
5
  "type": "module",
6
6
  "bin": {
package/src/cli.js CHANGED
@@ -37,7 +37,7 @@ ${bold('The record')}
37
37
  ${cyan('record verify')} verify the hash chain end to end
38
38
 
39
39
  ${bold('Portability')}
40
- ${cyan('compile')} [--target claude|agents|cursor|raw] [--loop <name>] [--write]
40
+ ${cyan('compile')} [--target claude|agents|gemini|cursor|raw] [--loop <name>] [--write]
41
41
  render loops into CLAUDE.md / AGENTS.md / Cursor rules
42
42
  ${cyan('mcp')} run the MCP server (stdio) for agent integration
43
43