KogCat

AI makes the answer smoother. KogCat makes the judgment sound.

English | 中文 · Website: <https://www.kogcat.com>

A local-first judgment calibration layer for Claude Code and Codex. Before you act on an AI answer, it surfaces the counterexamples, the boundaries, the blind spots — drawn from a knowledge base that lives on your machine. It won't replace your model. It won't slow you down. The call stays yours.

---

See the difference

"I read 30 minutes a day but nothing sticks. Should I take more detailed notes?"

Plain AI — Try the Cornell method, highlight key passages, add Anki for spaced repetition.

KogCat — More notes will likely make it worse. The bottleneck isn't capture. It's retrieval. Your knowledge base holds a claim you marked high-confidence: the "I get it" feeling while re-reading is the least reliable signal of real recall. So try this once — finish a section, close the book, write what you remember. Then compare it to what you thought you had.

---

When it speaks up

Built for judgment, not lookup. KogCat speaks up for the calls that cost you when they're wrong — decisions, tradeoffs, comparisons, critiques, strategy. It stays quiet for the rest: lookups, definitions, code, summaries, translation. And even on a judgment call, it adds a note only when it sees something the model didn't.

Automatic. Ask a judgment question in conversation. A note appears only when there's something worth saying — and your original answer is never touched.
On demand. /kogcat:query <question> puts your knowledge base first: a conclusion, the conditions that change it, a next step.

---

Install

Claude Code

/plugin marketplace add KogCat/cc-kogcat
/plugin install kogcat

Codex

codex plugin marketplace add KogCat/cc-kogcat
codex plugin add kogcat@kogcat

After installing, fully quit and reopen Claude Code (or restart Codex). The first-run download only starts on the next fresh session — the install command alone won't begin it.

On first launch, KogCat quietly downloads its engine (~40 MB) and embedding model (~90 MB). Once. About a minute on a good connection. Keep working while it does — run /kogcat:status anytime to watch each piece come online.

---

Use it from any MCP client

KogCat's calibration engine runs as a local sidecar; the Claude Code / Codex plugin is just one client of it. Any MCP-capable tool — Cursor, Cline, Zed, VS Code, Claude Desktop — can use the same engine through a standalone stdio MCP server.

Add this to your client's MCP config (field names vary slightly by client; most use an mcpServers map):

{
  "mcpServers": {
    "kogcat": {
      "command": "uvx",
      "args": ["kogcat-mcp"]
    }
  }
}

Requires uv, on macOS (Apple Silicon) or Windows x86_64 (same engine, same platforms as below). On first run it downloads the engine + embedding model and registers a background sidecar — the same one-time setup as the plugin, shared by every client on the machine. It exposes the knowledge-base tools (search, node, edges, calibrate, calibrate_review, and the memory_* family) for your model to call.

What you give up vs. the plugin. The Claude Code / Codex plugin adds two host conveniences a generic MCP client has no hook for: calibration that fires automatically on judgment questions, and a memory index injected into context at session start. With a standalone server your model reaches the same knowledge base, but it's the model that decides to call those tools — or you ask it to "use KogCat" — rather than a hook firing them for you. You never type the tool names (search, calibrate_review, memory_*); they're the model's to call.

---

Privacy

Your knowledge base stays on your machine. KogCat reads only the folder you point it at.
Your conversation goes to the same Claude or Codex you already use. Nothing extra, nowhere else.
Calibration happens in a local process. The results never leave.
The engine comes from a public release channel, checked against a sha256 manifest before it ever runs.

No account. No subscription. No one else holding your knowledge.

---

Commands

| Command | What it does | |---|---| | /kogcat:query <question> | A knowledge-base-first answer: conclusion, conditions, next step. | | /kogcat:status | A read-only local check. Reach for it if first launch seems stuck. | | /kogcat:memory-consolidate | Review and tidy saved memories — every change is yours to confirm. |

Automatic calibration needs no command.

---

Requirements

Claude Code or Codex
macOS (Apple Silicon) or Windows x86_64 — Intel Mac and Linux not yet supported
Python 3 on PATH — already there on macOS; on Windows, install it yourself (tick Add python.exe to PATH)

---

License

FSL-1.1-MIT — see LICENSE. Converts to MIT two years after each release.

cc-kogcat