<div align="center">

<h1>eeco — Claude Code plugin</h1>

  <p><i>Drive eeco's knowledge layer from inside Claude Code.</i></p>

<p>
    <a href="https://github.com/ajhahnde/eeco-claude-plugin/actions/workflows/ci.yml"><img src="https://img.shields.io/badge/CI-passing-brightgreen" alt="CI"></a>
    <a href="LICENSE"><img src="https://img.shields.io/badge/license-source--available-orange" alt="License"></a>
    <a href="https://github.com/ajhahnde/eeco"><img src="https://img.shields.io/badge/requires-eeco-blue" alt="Requires eeco"></a>
  </p>

</div>

---

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).