@agentic-patterns/cli 0.1.3 → 0.1.5
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 +14 -4
- package/assets/dashboard/assets/{index-C2JvJdBt.js → index-x4ivBrgq.js} +20 -20
- package/assets/dashboard/index.html +1 -1
- package/assets/plugin-template/.claude-plugin/plugin.json +13 -0
- package/assets/plugin-template/hooks/emit.mjs +42 -0
- package/assets/plugin-template/hooks/hooks.json +342 -0
- package/dist/cli.js +131 -21
- package/dist/cli.js.map +1 -1
- package/package.json +10 -7
package/README.md
CHANGED
|
@@ -26,7 +26,7 @@ cd my-agents
|
|
|
26
26
|
cp .env.example .env # add ANTHROPIC_API_KEY
|
|
27
27
|
bun install
|
|
28
28
|
bun run dev
|
|
29
|
-
# → http://localhost:
|
|
29
|
+
# → http://localhost:3456
|
|
30
30
|
```
|
|
31
31
|
|
|
32
32
|
The `--with-plugin` flag drops a Claude Code plugin (`.claude-plugin/` + `hooks/`) next to your project — any Claude Code session in that directory streams lifecycle events into your dashboard in real time.
|
|
@@ -55,7 +55,7 @@ Flags:
|
|
|
55
55
|
### `ap playground`
|
|
56
56
|
|
|
57
57
|
Starts a self-contained server + dashboard:
|
|
58
|
-
- Hono HTTP routes on port
|
|
58
|
+
- Hono HTTP routes on port 3456 (override with `--port`)
|
|
59
59
|
- Dashboard SPA mounted at `/` (skip with `--no-dashboard`)
|
|
60
60
|
- Auto-opens the browser (skip with `--no-open`)
|
|
61
61
|
- Wires `AgentEventBus` + `SSEExporter` so every agent interaction streams to the dashboard's `/admin/events/stream` endpoint
|
|
@@ -100,7 +100,7 @@ Override the discovery glob: `ap --agents "src/bots/*/index.ts" playground`
|
|
|
100
100
|
- `ANTHROPIC_API_KEY` → Anthropic runner
|
|
101
101
|
- `OPENAI_API_KEY` → OpenAI runner
|
|
102
102
|
- `OLLAMA_HOST` → local Ollama
|
|
103
|
-
- `AP_DASHBOARD_URL` → where the Claude Code plugin POSTs hooks (default `http://localhost:
|
|
103
|
+
- `AP_DASHBOARD_URL` → where the Claude Code plugin POSTs hooks (default `http://localhost:3456`)
|
|
104
104
|
|
|
105
105
|
Run `ap config` to verify detection. Run `ap config set` for an interactive editor.
|
|
106
106
|
|
|
@@ -110,7 +110,17 @@ When scaffolded with `--with-plugin`, the plugin wires all 26 Claude Code lifecy
|
|
|
110
110
|
|
|
111
111
|
This means any Claude Code session in a project with the plugin enabled becomes live-observable in your dashboard — tool calls, permission prompts, subagent spawns, compaction, everything.
|
|
112
112
|
|
|
113
|
-
|
|
113
|
+
### What gets scaffolded
|
|
114
|
+
|
|
115
|
+
`ap init --with-plugin` drops three artifacts:
|
|
116
|
+
|
|
117
|
+
- `.claude-plugin/plugin.json` — manifest for the marketplace / `/plugin add` install flow
|
|
118
|
+
- `hooks/{emit.mjs,hooks.json}` — the shim + event registry
|
|
119
|
+
- `.claude/settings.json` — activates the hooks immediately, no marketplace step required
|
|
120
|
+
|
|
121
|
+
If you already have a `.claude/settings.json` (your own permissions, model, or hooks), `ap init` merges non-destructively: preserves every existing key, adds our hook entries only where not already present. Re-running is idempotent. Malformed existing JSON is backed up rather than replaced.
|
|
122
|
+
|
|
123
|
+
See [docs/CLAUDE-CODE-PLUGIN-ACTIVATION.md](../../docs/CLAUDE-CODE-PLUGIN-ACTIVATION.md) for the full activation model, the list of captured events, and troubleshooting.
|
|
114
124
|
|
|
115
125
|
## License
|
|
116
126
|
|