Open-source · by EraCode

Stop losing track of your own codebase

Sure, we ship faster with agents, but we are less in tune with the codebase as a result. Even without agents, are you in tune with that feature another developer shipped? Refresh your code ownership with a sip of coffee sized piece of info about your repo.

View on GitHub

Install

Pick your agent, copy the command, open the repo you are shipping from.

  1. Add the marketplace

    /plugin marketplace add RMPasta/codebase-coffee

  2. Install the plugin

    /plugin install codebase-coffee@codebase-coffee

  3. Open your repo

    Morning coffee may appear automatically—or run `/codebase-coffee` anytime.

Morning offer is optional. Dismiss it or start manually whenever you want.

What you get

  • Your repo, not a tutorial

    One real pattern from the codebase you have open—with file pointers and one gotcha.

  • Under a minute

    The whole brief fits on a phone screen. Brevity is the product.

  • Picks up where you left off

    `.codebase-coffee.md` at the repo root tracks what you already covered.

Example daily brief

Meter dedupe uses an idempotent insert: rows carry a source id, and a unique constraint on `(meter_id, source_id)` makes replays no-ops. That lives in `backend/meters/models.py` and the ingest path in `backend/meters/services.py:42`. Gotcha: partial retries can hit the same constraint—treat a duplicate as success. Go deeper?

Why it exists

The failure mode is not using AI—it is waking up and not knowing where decisions live, which invariants matter, or how a change ripples through the system you maintain.

Coffee is a small orientation habit. Not another assistant. Not a docs rewrite. One concept per day, grounded in files you actually touch.

What a coffee looks like

Under 100 words: pattern, why, file pointers, gotcha. First run scans the repo and writes .codebase-coffee.md at the root so the next pick moves forward.

Say yes to “Go deeper?” if you want a short walkthrough. Most days you will not need it.

Good to know

Runs in your coding agent—not the EraCode app. In Claude Code you may get a morning offer; elsewhere run /codebase-coffee yourself.