contextus
Proactive context delivery — automatic semantic retrieval of project patterns from .claude/context/, injected on every prompt.
Plugin contextus from marketplace claude-contextus in equiphealth/claude-contextus. Commands read from the repo's manifest — 6 days ago.
This plugin runs code on your machine — its hooks fire automatically on events like tool use. The exact commands are listed below; read them before installing.
What it installs
Skills (24)
add-patternsBulk import patterns from external sources — JSON file, CSV, or directory scan. Validates structure, deduplicates, and embeds. Future feature.
configureView and edit contextus project config (.claude/contextus.jsonc) — sources, excludes, retrieval tuning, docs settings, capture mode. The single entry point for all config changes.
context-archiveArchive low-value patterns — move noisy/stale/obsolete patterns to .claude/context/.archive/. Supports bulk operations (--stale, --unused) and single-file archival. Removes from LanceDB but preserves file content.
context-auditAudit corpus quality — structural issues (missing frontmatter, type mismatches), staleness (not modified in 6+ months), and usage patterns (not retrieved). Comprehensive health check with suggested fixes.
context-calibrateQuality measurement and optimization — evaluate whether injected context is actually USED (--floor to tune injection threshold, --campaign for bounded sampling). Proves whether contextus is working.
context-doctorTroubleshoot issues — daemon health, retrieval problems, DB corruption, config errors
context-mergeMerge duplicate patterns — LLM-assisted workflow to combine overlapping context files. Uses eval model (Haiku) to read both files, detect content overlap, and generate a unified version. Original kept, duplicate archived.
context-reviewCurate corpus — archive noisy patterns, merge duplicates, flag for rewrite
context-searchSearch corpus by semantic similarity. Returns matching patterns with scores, descriptions, and types. Use --limit N for more results, --scores to show similarity.
context-statsUsage analytics for injected context — show what's working, what's noisy, what's stale
context-statusHealth dashboard for contextus — corpus stats, daemon health, recent embeddings, injection coverage, calibration quality metrics. The go-to diagnostic when something feels off.
context-tagManage tags on context files — backfill missing (--backfill), AI-suggested improvements (--suggest), or bulk-update. Improves discoverability and classification.
contextus-setupGuided setup wizard — scaffold, configure, and embed for a project. Two tracks (quick/power user). First-run or re-configure.
contextus-upgradeRun after installing/updating contextus — migrates config, database, and linked projects to match the current version.
contextus-watchLive activity stream — colored, formatted follower over daemon.log showing retrievals, no-injects, errors, embeds in real time. The "what is contextus doing?" command.
create-contextCapture a new pattern/decision/implementation note into .claude/context/ with validation, deduplication, proper structure (frontmatter + body), and auto-embed.
create-docCreate documentation in docs/ with the same frontmatter schema as context files — name, description, metadata.type, metadata.tags. Improves retrieval quality and audit coverage.
ctxQuick dispatcher — /ctx status|stats|create|calibrate|doctor|watch|daemon|setup|link|search|review|rebuild|mine
link-projectLink another project's context patterns into this corpus — shared patterns rank at 0.85 (below own). For multi-repo workflows.
manage-daemonStop, start, or restart the contextus daemon. Use after config changes or when the daemon is unhealthy.
migrate-memoryConvert .claude/memory/ to .claude/context/ with proper typing, tags, and retrieval-optimized frontmatter
mine-transcriptsMine past Claude Code session transcripts for patterns that were never captured live — the retrospective safety net
rebuild-embeddingsRebuild entire corpus — re-embed all context files, docs, and user memory
use-jest-for-testingAlways use Jest as test framework
Hooks (6)
- SessionStart
node "${CLAUDE_PLUGIN_ROOT}/scripts/session-start-hook.js"
- UserPromptSubmit
node "${CLAUDE_PLUGIN_ROOT}/scripts/query-hook.js"
- UserPromptSubmit
node "${CLAUDE_PLUGIN_ROOT}/scripts/awareness-hook.js"
- PostToolUse
node "${CLAUDE_PLUGIN_ROOT}/scripts/watch-contexts.js"
- Stop
node "${CLAUDE_PLUGIN_ROOT}/scripts/stop-evaluation.js"
- Stop
node "${CLAUDE_PLUGIN_ROOT}/scripts/capture-gate-hook.js"
Maintain contextus?
This page updates itself from your repo. Add the badge to your README, or get it Featured to pin it above the organic results with a followed link to your site.