Ctx

Extract a small, high-signal context packet around ripgrep matches (bounded by hits/files/output budget) for fast LLM consumption.

majiayu000 72aefc4 2 files · 1.9 KB Updated 567 repo stars

File contents

ctx

Use this skill when

  • You need to show the agent a small amount of source context around a pattern/symbol without pasting whole files.
  • The repository is large and token budget matters.

Command

ctx 'PATTERN' .
ctx 'literal string' . -F
ctx 'PATTERN' path/to/file.py
ctx 'PATTERN' . --no-scope
ctx 'PATTERN' . --prefer torch --prefer aten
ctx 'PATTERN' . --json

# (fallback if wrappers are not on PATH)
CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
python3 "$CODEX_HOME/skills/ctx/scripts/ctx.py" 'PATTERN' . --no-scope -C 3 --max-hits 60 --max-files 20 --max-output-lines 500

Notes

  • Uses rg --vimgrep for fast match discovery and can stop early once --max-hits is reached.
  • Reads each matched file at most once, merges overlapping context windows, then prints a bounded packet.

majiayu000/claude-skill-registry-data/tree/main/development/ctx commit 72aefc41ef

Frequently asked questions

npx skillmds add majiayu000/ctx-2