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.
- package/README.md +46 -2
- package/package.json +1 -1
- 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,
|
|
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.
|
|
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
|
|