claude

contextus

Proactive context delivery — automatic semantic retrieval of project patterns from .claude/context/, injected on every prompt.

3 on GitHubby Anthony Dawsonv0.20.0MITupdated 10 days ago
/

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-patterns

    Bulk import patterns from external sources — JSON file, CSV, or directory scan. Validates structure, deduplicates, and embeds. Future feature.

  • configure

    View 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-archive

    Archive 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-audit

    Audit 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-calibrate

    Quality 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-doctor

    Troubleshoot issues — daemon health, retrieval problems, DB corruption, config errors

  • context-merge

    Merge 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-review

    Curate corpus — archive noisy patterns, merge duplicates, flag for rewrite

  • context-search

    Search corpus by semantic similarity. Returns matching patterns with scores, descriptions, and types. Use --limit N for more results, --scores to show similarity.

  • context-stats

    Usage analytics for injected context — show what's working, what's noisy, what's stale

  • context-status

    Health dashboard for contextus — corpus stats, daemon health, recent embeddings, injection coverage, calibration quality metrics. The go-to diagnostic when something feels off.

  • context-tag

    Manage tags on context files — backfill missing (--backfill), AI-suggested improvements (--suggest), or bulk-update. Improves discoverability and classification.

  • contextus-setup

    Guided setup wizard — scaffold, configure, and embed for a project. Two tracks (quick/power user). First-run or re-configure.

  • contextus-upgrade

    Run after installing/updating contextus — migrates config, database, and linked projects to match the current version.

  • contextus-watch

    Live activity stream — colored, formatted follower over daemon.log showing retrievals, no-injects, errors, embeds in real time. The "what is contextus doing?" command.

  • create-context

    Capture a new pattern/decision/implementation note into .claude/context/ with validation, deduplication, proper structure (frontmatter + body), and auto-embed.

  • create-doc

    Create documentation in docs/ with the same frontmatter schema as context files — name, description, metadata.type, metadata.tags. Improves retrieval quality and audit coverage.

  • ctx

    Quick dispatcher — /ctx status|stats|create|calibrate|doctor|watch|daemon|setup|link|search|review|rebuild|mine

  • link-project

    Link another project's context patterns into this corpus — shared patterns rank at 0.85 (below own). For multi-repo workflows.

  • manage-daemon

    Stop, start, or restart the contextus daemon. Use after config changes or when the daemon is unhealthy.

  • migrate-memory

    Convert .claude/memory/ to .claude/context/ with proper typing, tags, and retrieval-optimized frontmatter

  • mine-transcripts

    Mine past Claude Code session transcripts for patterns that were never captured live — the retrospective safety net

  • rebuild-embeddings

    Rebuild entire corpus — re-embed all context files, docs, and user memory

  • use-jest-for-testing

    Always 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"

View source on GitHub

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.

claude & codex pluginslisted