About Context Guru
Context Guru is an MCP server published by rossoctl in the Agents category: context optimization for AI coding agents — lower token cost and latency without sacrificing accuracy.
The repository has 70 stars and 24 forks, with the last commit 10 hours ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/rossoctl/context-guruThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Context Guru
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 10 hours ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
2 checks have not been run yet.
Releases
README
context-guru
Provider-agnostic context engineering for LLM agents.
context-guru cuts the token cost of your agent's traffic in two ways: carry less context (drop redundant tool output, collapse superseded runs, summarize before you hit the limit), and pay less for what you still carry (keep your prompt cache warm, split the volatile tail off the system prompt so the rest stays cacheable). Paying less is the default — it's on out of the box, before you opt into anything that trims content.
Full docs: rossoctl.github.io/context-guru.
Install
Choose your setup. Each button opens only the instructions for that path.
What's cool
The status line shows your savings live, for the main session and for every subagent. It also shows the cache clock, the context fill and the keep-alive pings. This frame comes from a real, week-long release session:
/context-guru:insights tells you what you saved, what your cache costs you, and what you carry and never use.
Real output, 7 days of one developer's work:
More:
- Save more: replay your own history and find the config that costs least.
- Remove tools: find the MCP servers and skills you never use, and remove them.
- Dashboard: every request, every saving, in your browser.
Every command: docs/plugin/commands.md. Full guide, every status line state and troubleshooting: rossoctl.github.io/context-guru/plugin.
Presets
It's an effort ladder — each tier is everything in the one before it, plus more:
| Preset | What it adds | Spends on its own |
|---|---|---|
off |
nothing — requests forwarded untouched (the default; only keep-alive spends, if that's on) | no |
conservative |
deterministic trimming of tool output (repeats, dead runs) — no model calls | no |
medium |
conservative plus a cheap model that keeps only what looks relevant in recent tool output, and a summary prepared in the background that is used only if you come back after the cache expired |
yes |
high |
medium, but the summary of older turns is used as soon as the context window is nearly full |
yes |
xhigh |
high plus a periodic deep-adjudication sweep over turns whose prompt cache has gone cold — the deepest cut |
yes |
Run the picker any time to switch tiers—it explains each one before asking which to set:
| Claude Code | Codex (experimental) |
|---|---|
/context-guru:preset-picker |
$context-guru-preset-picker |
Claude Code applies the change at the next proxy start; Codex restarts its owned proxy after the
selection. Confirm the result with /context-guru:status on Claude Code or
$context-guru-status on Codex. Full pipelines:
docs/reference/presets.md.
Everything else — architecture, the full benchmark, every component, the proxy/gateway path, config reference — is in docs/design.md and docs/get-started/how-it-saves.md.
Updating
The proxy binary is what matters and what changes often. Claude Code checks for a newer release in routed sessions and offers update choices; Codex checks when you invoke its update skill. Update it any time with the command for your client:
| Claude Code | Codex (experimental) |
|---|---|
/context-guru:update |
$context-guru-update |
Codex does not check or install proxy updates automatically. Codex users should run
$context-guru-update periodically. It checks only; when an update is available, exit Codex and
run ~/.local/state/context-guru-codex/context-guru-update in an ordinary shell, then start a new
session.
The plugin itself (skills, hooks, scripts) rarely needs updating — most releases only touch the proxy binary, which the update command above already covers. To refresh the plugin itself:
| Claude Code | Codex (experimental) |
|---|---|
/plugin marketplace update rossoctl/context-guru/reload-plugins |
codex plugin marketplace upgrade context-guruThen restart Codex. |
Codex remembers the sparse paths from marketplace registration and reuses them during upgrade;
the upgrade command does not take separate --sparse flags. For an older registration that was
created without sparse paths and now times out, follow the one-time re-registration steps in the
Codex troubleshooting guide.
More: docs/how-to/install-plugin.md.
Troubleshooting
If a routed session cannot start or answer, run the client-specific recovery script from an ordinary shell. It needs no working agent session, proxy, or network:
| Claude Code | Codex (experimental) |
|---|---|
~/.local/state/context-guru/context-guru-reset |
~/.local/state/context-guru-codex/context-guru-reset |
Prefer recovery over an in-session uninstall when the session is stuck: a dead proxy prevents the request that would invoke the uninstall skill. More troubleshooting: Claude Code or Codex.
Remove context-guru routing with:
| Claude Code | Codex (experimental) |
|---|---|
/context-guru:uninstall |
Exit Codex, then run ~/.local/state/context-guru-codex/context-guru-reset --yes in an ordinary shell. |
On Claude Code, uninstall affects the install routing the current project, while the recovery
script un-routes every settings file the plugin edited. Codex routing is user-wide, so its
standalone reset restores the previously selected default provider. Do not stop the proxy from a
routed Codex session: that session cannot change transport and its remaining turns will be
stranded. $context-guru-uninstall only plans the removal and shows the shell command. Neither
client's removal flow removes the marketplace registration or plugin package itself. Codex reset
does remove a proxy binary downloaded into its private state directory; it never removes a binary
that setup reused from PATH.
More: docs/how-to/install-plugin.md.
Upgrading Claude Code from project level to user level
Installed in one project and now want it everywhere? Install again with --global and keep both —
each gets its own port, and a project you later reset falls back to the machine-wide one.
/context-guru:install --global
More: docs/how-to/install-plugin.md.
Codex does not have this project/user routing split: $context-guru-setup configures the user's
default provider for ordinary Codex sessions.
License
README fetched from the repository 10 hours ago. The original is authoritative.