mksglu/context-mode

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/mksglu/context-mode.svg?style=card)](https://bestofgithub.dev/repo/mksglu/context-mode)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/mksglu/context-mode.svg)](https://bestofgithub.dev/repo/mksglu/context-mode)

Loading README…

Slash Command	What it does
`/context-mode:ctx-stats`	Context savings — per-tool breakdown, tokens consumed, savings ratio.
`/context-mode:ctx-doctor`	Diagnostics — runtimes, hooks, FTS5, plugin registration, versions.
`/context-mode:ctx-index`	Index a local file or directory into the persistent FTS5 knowledge base.
`/context-mode:ctx-search`	Search previously indexed content.
`/context-mode:ctx-upgrade`	Pull latest, rebuild, migrate cache, fix hooks.
`/context-mode:ctx-purge`	Permanently delete all indexed content from the knowledge base.
`/context-mode:ctx-insight`	Opens the hosted Insight dashboard (context-mode.com/insight) in your browser — org analytics for AI-assisted engineering teams.

Tool	What it does	Context saved
`ctx_batch_execute`	Run multiple commands + search multiple queries in ONE call. Opt-in `concurrency: 1-8` for I/O-bound batches.	986 KB → 62 KB
`ctx_execute`	Run code in 12 languages. Only stdout enters context.	56 KB → 299 B
`ctx_execute_file`	Process files in sandbox. Raw content never leaves.	45 KB → 155 B
`ctx_index`	Chunk markdown into FTS5 with BM25 ranking.	60 KB → 40 B
`ctx_search`	Query indexed content with multiple queries in one call.	On-demand retrieval
`ctx_fetch_and_index`	Fetch URL, chunk and index. Cache reuses content within TTL (default 24h, override per-call with `ttl: <ms>`). `ttl: 0` or `force: true` to bypass. Pass `requests: [{url, source}, ...]` + `concurrency: 1-8` for parallel multi-URL.	60 KB → 40 B
`ctx_stats`	Show context savings, call counts, and session statistics.	—
`ctx_doctor`	Diagnose installation: runtimes, hooks, FTS5, versions.	—
`ctx_upgrade`	Upgrade to latest version from GitHub, rebuild, reconfigure hooks.	—
`ctx_purge`	Permanently deletes all indexed content from the knowledge base.	—

Hook	Role	Claude Code	Gemini CLI	VS Code Copilot	JetBrains Copilot	GitHub Copilot CLI	Cursor	OpenCode	KiloCode	OpenClaw	Codex CLI	Antigravity	Antigravity CLI (`agy`)	Kiro	Zed	Pi	OMP
PreToolUse	Enforces sandbox routing before tool execution	Yes	--	--	--	Yes	Yes	--	--	--	Yes	--	Bounded	Yes	--	✓ (via tool_call event)	✓ (via tool_call event)
PostToolUse	Captures events after each tool call	Yes	Yes	Yes	Yes	Yes	Yes	Plugin	Plugin	Plugin	Yes	--	Yes (capture-only)	Yes	--	✓ (via tool_result event)	✓ (via tool_result event)
UserPromptSubmit	Captures user decisions and corrections	Yes	--	--	--	Yes	--	Plugin (via chat.message)	Plugin (via chat.message)	--	Yes	--	--	--	--	--	--
Stop	Captures assistant turn-end state	Yes	--	--	--	Yes	Yes	--	--	--	Yes	--	Best-effort	--	--	--	--
PreCompact	Builds snapshot before compaction	Yes	Yes	Yes	Yes	Yes	--	Plugin	Plugin	Plugin	Yes	--	--	--	--	✓ (via session_before_compact)	✓ (via session_before_compact)
SessionStart	Restores state after compaction or resume	Yes	Yes	Yes	Yes	Yes	--	✓ (via experimental.chat.system.transform)	✓ (via experimental.chat.system.transform)	Plugin	Yes	--	--	--	--	✓ (via session_start event)	✓ (via session_start event)
	Session completeness	Full	High	High	High	High	Partial	Full	Full	High	Partial	--	Partial	Partial	--	High	High

Category	Events	Priority	Captured By
Files	read, edit, write, glob, grep	Critical (P1)	PostToolUse
Tasks	create, update, complete	Critical (P1)	PostToolUse
Plans	enter, exit, approved, rejected, file write	Critical (P1)	PostToolUse
Rules	CLAUDE.md / GEMINI.md / AGENTS.md paths + content	Critical (P1)	SessionStart
User Prompts	Every user message (for last-prompt restore)	Critical (P1)	UserPromptSubmit
Decisions	User corrections, preferences ("use X instead", "don't do Y")	High (P2)	UserPromptSubmit
Git	checkout, commit, merge, rebase, stash, push, pull, diff, status	High (P2)	PostToolUse
Errors	Tool failures, non-zero exit codes	High (P2)	PostToolUse
Error Resolution	Error → fix pairs detected across sequential tool calls	High (P2)	PostToolUse
Constraints	Discovered limitations ("not supported", "permission denied")	High (P2)	PostToolUse
Blockers	"blocked on", "waiting for", "depends on" — tracked until resolved	High (P2)	UserPromptSubmit
Rejected Approaches	Tool calls denied by user (PreToolUse → PostToolUse marker)	High (P2)	PreToolUse
Environment	cwd changes, venv, nvm, conda, worktree, package installs	High (P2)	PostToolUse
Agent Findings	Completed subagent results (first 500 chars)	High (P2)	PostToolUse
Iteration Loops	Same tool called 3+ times with similar input (retry detection)	High (P2)	PostToolUse
Latency	Tool calls exceeding 5s (tool name + duration in ms)	Normal (P3)	PreToolUse
MCP Tools	All `mcp__*` tool calls with usage counts	Normal (P3)	PostToolUse
Subagents	Agent tool launches and completions	Normal (P3)	PostToolUse
Skills	Slash command invocations	Normal (P3)	PostToolUse
External Refs	URLs, GitHub issue references (#123), deduped	Normal (P3)	PostToolUse
Role	Persona / behavioral directives ("act as senior engineer")	Normal (P3)	UserPromptSubmit
Intent	Session mode classification (investigate, implement, review)	Low (P4)	UserPromptSubmit
Data	Large user-pasted data references (>1 KB)	Low (P4)	UserPromptSubmit

Feature	Claude Code	Qwen Code	Gemini CLI	VS Code Copilot	JetBrains Copilot	GitHub Copilot CLI	Cursor	OpenCode	KiloCode	OpenClaw	Codex CLI	Kimi Code	Antigravity	Antigravity CLI (`agy`)	Kiro	Zed	Pi	OMP
MCP Server / Native Tools	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Native plugin	Native plugin	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes
PreToolUse Hook	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Plugin	Plugin	Plugin	Yes	Yes	--	Bounded	Yes	--	Yes (extension)	Plugin
PostToolUse Hook	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Plugin	Plugin	Plugin	Yes	Yes	--	Yes (capture-only)	Yes	--	Yes (extension)	Plugin
SessionStart Hook	Yes	Yes	Yes	Yes	Yes	Yes	--	✓ (via experimental.chat.system.transform)	✓ (via experimental.chat.system.transform)	Plugin	Yes	Yes	--	--	--	--	Yes (extension)	Plugin
PreCompact Hook	Yes	Yes	Yes	Yes	Yes	Yes	--	Plugin	Plugin	Plugin	Yes	Yes	--	--	--	--	Yes (extension)	Plugin
Can Modify Args	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Plugin	Plugin	Plugin	--	Yes	--	--	--	--	Yes (extension)	--
Can Block Tools	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Plugin	Plugin	Plugin	Yes	Yes	--	Bounded	Yes	--	Yes (extension)	Plugin
Utility Commands (ctx)	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes (/ctx-stats, /ctx-doctor)	Yes
Slash Commands	Yes	--	--	--	--	--	--	--	--	--	--	--	--	--	--	--	--	--
Plugin Marketplace	Yes	--	--	--	--	--	--	--	--	--	--	--	--	--	--	--	--	--

mksglu/context-mode

Context Mode

The Problem

How Context Mode Solves It

Install

Option A — Marketplace plugin (recommended once published)

Option B — Manual install (existing path)

Tools

How the Sandbox Works

How the Knowledge Base Works

Ranking: Reciprocal Rank Fusion

Proximity Reranking

Fuzzy Correction

Smart Snippets

TTL Cache

Progressive Throttling

Session Continuity

Platform Compatibility

Routing Enforcement

Utility Commands

Benchmarks

Try It

Privacy & Architecture

Security

Project-boundary containment

Network fetch hardening

Storage environment variables

Routing-guidance environment variables

Contributing

License

Platform	Hooks	Instruction File	With Hooks	Without Hooks
Claude Code	Yes (auto)	`CLAUDE.md`	~98% saved	~60% saved
Gemini CLI	Yes	`GEMINI.md`	~98% saved	~60% saved
VS Code Copilot	Yes	`copilot-instructions.md`	~98% saved	~60% saved
JetBrains Copilot	Yes	`copilot-instructions.md`	~98% saved	~60% saved
GitHub Copilot CLI	Yes	`copilot-instructions.md`	~98% saved	~60% saved
Cursor	Yes	`context-mode.mdc`	~98% saved	~60% saved
OpenCode	Plugin	`AGENTS.md`	~98% saved	~60% saved
OpenClaw	Plugin	`AGENTS.md`	~98% saved	~60% saved
Codex CLI	Yes	`AGENTS.md`	~98% saved	~60% saved
Antigravity	--	`GEMINI.md`	--	~60% saved
Antigravity CLI (`agy`)	Bounded	routing rule + skill (`rules`, `skill`)	bounded Bash/Read/Grep/WebFetch enforcement	~60% saved
Kiro	Yes	`KIRO.md`	~98% saved	~60% saved
Zed	--	`AGENTS.md`	--	~60% saved
Pi	✓	`AGENTS.md`	~98% saved	~60% saved
OMP	Plugin	`SYSTEM.md`	~98% saved	~60% saved

Scenario	Raw	Context	Saved
Playwright snapshot	56.2 KB	299 B	99%
GitHub Issues (20)	58.9 KB	1.1 KB	98%
Access log (500 requests)	45.1 KB	155 B	100%
Context7 React docs	5.9 KB	261 B	96%
Analytics CSV (500 rows)	85.5 KB	222 B	100%
Git log (153 commits)	11.6 KB	107 B	99%
Test output (30 suites)	6.0 KB	337 B	95%
Repo research (subagent)	986 KB	62 KB	94%