<div align="center">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="../assets/eeco_logo_dark.png">
    <img src="../assets/eeco_logo_light.png" alt="eeco" width="280">
  </picture>

<h1>Claude Code plugin</h1>

<p><i>eeco's highest-value verbs as slash commands inside a Claude Code session.</i></p>

<p>
    <a href="../README.md"><b>README</b></a> ·
    <a href="../VISION.md"><b>Vision</b></a> ·
    <a href="COCKPIT.md"><b>Cockpit</b></a> ·
    <a href="USAGE.md"><b>Usage</b></a> ·
    <a href="ARCHITECTURE.md"><b>Architecture</b></a> ·
    <a href="PUBLIC_API.md"><b>Public API</b></a> ·
    <a href="../VERSIONING.md"><b>Versioning</b></a> ·
    <a href="../CHANGELOG.md"><b>Changelog</b></a> ·
    <a href="../SECURITY.md"><b>Security</b></a>
  </p>

</div>

---

eeco ships a small [Claude Code](https://github.com/ajhahnde/eeco-claude-plugin)
plugin that exposes the highest-value eeco verbs as user-triggered slash
commands inside a Claude Code session, and (from v0.2.0) grounds each session
with eeco's context brief. The plugin is a thin wrapper: it bundles no binary
and makes no AI calls of its own — everything shells out to the `eeco` binary
on your `PATH` and brings its output into the conversation.

The plugin lives in its own repository,
[`ajhahnde/eeco-claude-plugin`](https://github.com/ajhahnde/eeco-claude-plugin),
with its own release lifecycle; this page is a pointer.

## Prerequisite

The `eeco` binary must be installed and on your `PATH` (any `v0.x`) — see
[Install](../README.md#install). The plugin does not install eeco for you.

## Install

From inside Claude Code:

```text
/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`.
- **`/eeco:ask`** — a deterministic, no-AI-spend ranked search over memory and
  project knowledge. Pass through `--limit`, `--json`.
- **`/eeco:report-bug`** — file a friction report; writes a local record and
  prints a pre-filled issue URL (nothing is sent automatically). Pass through
  `--note`, `--cmd`.

## Session briefer

From **v0.2.0**, installing the plugin also bundles a SessionStart hook that
auto-injects eeco's deterministic context brief (the same readout as
[`eeco go`](USAGE.md)) into a Claude Code session at startup, resume, and
clear — so the session begins already grounded in your knowledge layer. The
briefer makes no AI call, emits nothing in a non-eeco repo, and no-ops when
`eeco` is not on your `PATH`. The
[plugin README](https://github.com/ajhahnde/eeco-claude-plugin#what-installing-wires-up)
is the source of truth for its behaviour and the install-time consent it implies.

## Feedback

`/eeco:report-bug` is the friction channel — it records the rough edge locally
and hands you a pre-filled issue URL for the
[eeco repository](https://github.com/ajhahnde/eeco).

---

[← Back: README](../README.md) · [Plugin repository →](https://github.com/ajhahnde/eeco-claude-plugin)