ajhahn.de
← all repos

Repository

eeco-claude-plugin

eeco's Claude Code plugin — drive the no-AI-spend knowledge layer (/eeco:go, /eeco:ask, /eeco:report-bug) from inside Claude Code.

Markdown · updated May 2026

main

Languages

  • Markdown 82.6%
  • JSON 11.2%
  • YAML 6.2%

Readme

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 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 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 — 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 and the eeco commercial-license terms.

Recent commits

Files