Skip to content

Add docket install: make docket ambient in a repo with one command#13

Merged
claude[bot] merged 1 commit into
mainfrom
claude/enhancements-learnings-7ug5p0
Jul 4, 2026
Merged

Add docket install: make docket ambient in a repo with one command#13
claude[bot] merged 1 commit into
mainfrom
claude/enhancements-learnings-7ug5p0

Conversation

@claude

@claude claude Bot commented Jul 4, 2026

Copy link
Copy Markdown

Answers "how do I install docket so it runs whenever an agent touches the repo?" — one command sets up both layers and commits them with the code.

$ docket install
✓ docket installed into .
  CLAUDE.md · AGENTS.md · GEMINI.md · .cursor/rules/docket.mdc
  .claude/settings.json · .mcp.json

Two layers, set up together:

  • Context, for free — compiles the loops into every agent's context file (CLAUDE.md / AGENTS.md / GEMINI.md / Cursor rules), read automatically at session start. Anyone who clones is under the warrant with zero setup.
  • Enforcement, mechanical — writes a Claude Code PreToolUse hook into .claude/settings.json and a .mcp.json for native tools.

Posture: pass-through by default (routes by content, silent on work no loop covers); --loop pins one loop, --strict asks on anything uncovered.

Safe by construction:

  • Merge-safe — existing settings.json hooks and .mcp.json servers are preserved; refuses to clobber a settings.json it can't parse.
  • Idempotent — re-run after adding a loop to refresh context without duplicating the hook.
  • --no-hook / --no-mcp for context-only; --targets claude,agents to narrow.

Docs: README "Make it run for every agent in a repo" + docs-site quickstart & CLI reference. 9 new install tests; 118 total green.

🤖 Generated with Claude Code


Generated by Claude Code

Compiles the loops into every agent's context file (CLAUDE.md, AGENTS.md,
GEMINI.md, Cursor rules), wires a Claude Code PreToolUse hook into
.claude/settings.json, and drops a .mcp.json for native tools — so any agent
that touches the repo is under the warrant, with zero setup for anyone who
clones.

- Pass-through hook by default (routes by content, silent on uncovered work);
  --loop pins one loop, --strict asks on anything no loop covers
- Merge-safe: existing settings.json hooks and .mcp.json servers preserved;
  refuses to clobber a settings.json it can't parse
- Idempotent: re-running after adding a loop refreshes context without
  duplicating the hook
- --no-hook / --no-mcp for context-only, --targets to narrow the context files

9 install tests; 118 total green.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Uc3rGARtDBoXkqMFgppaP4
@claude claude Bot merged commit 6f1341e into main Jul 4, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant