eeco — Claude Code plugin

Drive eeco's knowledge layer from inside Claude Code.

CI License Requires eeco

--- This plugin connects Claude Code to the [`eeco`](https://github.com/ajhahnde/eeco) binary: three user-triggered slash commands and a SessionStart briefer that grounds each session in your project's deterministic context. It bundles no binary and makes no AI calls of its own — everything runs `eeco` locally and brings its output into your conversation. ## Prerequisites The `eeco` binary must be installed and on your `PATH` (any `v1.x`). See the [eeco repository](https://github.com/ajhahnde/eeco) for install instructions. Verify with: ``` eeco --version ``` ## Install From inside Claude Code: ``` /plugin marketplace add ajhahnde/eeco-claude-plugin /plugin install eeco@ajhahnde ``` ## Commands - **`/eeco:go`** — assemble and read eeco's deterministic context brief (the knowledge layer distilled). Pass through `--brief`, `--json`, `--metrics`, `--copy`, `--write PATH`. Example: `/eeco:go --metrics`. - **`/eeco:ask`** — a deterministic, no-AI-spend ranked search over memory and project knowledge. Pass through `--limit N`, `--json`. Example: `/eeco:ask deployment steps --limit 5`. - **`/eeco:report-bug`** — file a friction report; writes a local record and prints a pre-filled GitHub-issue URL (nothing is sent automatically). Pass through `--note TEXT`, `--cmd CMD`. Example: `/eeco:report-bug --note "brief was slow" --cmd "eeco go"`. ## What installing wires up Beyond the slash commands, installing this plugin activates a **SessionStart briefer**: at the start of a session (startup, resume, or clear) it runs `eeco hooks session-emit --if-initialized` and injects eeco's deterministic, no-AI-spend project brief as context — so Claude begins each session already grounded in your knowledge layer. The briefer is read-only and quiet: it makes **no AI call**, emits **nothing** in a non-eeco repo (it only briefs inside an initialized eeco workspace — requires eeco ≥ v1.15.0 for that gate), and no-ops harmlessly when `eeco` isn't on your `PATH`. It never blocks or slows a session. **Install = consent.** Claude Code activates a plugin's bundled hooks when you enable the plugin — there is no separate per-hook prompt. Disabling or uninstalling the plugin removes the hook. ## Feedback Hit a rough edge? Use **`/eeco:report-bug`** — it records the friction locally and hands you a pre-filled issue URL. ## See also - [eeco](https://github.com/ajhahnde/eeco) — the AI-agnostic knowledge layer and workflow companion this plugin drives. ## License PolyForm Noncommercial 1.0.0 — free for noncommercial use; commercial use requires a separate license. See [LICENSE](LICENSE) and the [eeco commercial-license terms](https://github.com/ajhahnde/eeco/blob/main/COMMERCIAL-LICENSE.md).