codegraph

What it does and when to use it

Configure or refresh CodeGraph for UCCIF in Codex. Use for $uccif:codegraph, indexing or reindexing a project. Ask before installing missing dependencies.

How it works

SKILL.md has no level-two headings · 22 lines, 208 words

---
name: codegraph
description: "Configure or refresh CodeGraph for UCCIF in Codex. Use for $uccif:codegraph, indexing or reindexing a project. Ask before installing missing dependencies."
---

Use Python 3.8+ and the [bundled UCCIF entry point](../../core/scripts/uccif_main.py).
Resolve that link relative to this SKILL.md directory, not the project cwd.
In the commands below, `UCCIF` means the Python interpreter followed by that
resolved absolute script path, quoted separately for the current shell.
Run from the user's project directory. Do not run a literal executable named UCCIF.
This plugin does not install hooks or automatically track edits.

# CodeGraph for Codex

1. Run `UCCIF codegraph --host codex` and check `codegraph --version` if available.
2. If the CLI is missing, ask before installing `@colbymchenry/codegraph`. Never install the
   unrelated unscoped `codegraph` package. Never run `npx codegraph`.
3. If MCP is not configured, preview `UCCIF setup codex --with-codegraph --dry-run`,
   then apply the same setup without `--dry-run` within the user's authorized setup request.
   Preserve conflicts; do not register a second plugin/user/project server.
4. Run `codegraph init --yes` at the project root when indexing was requested and the CLI
   is available; then `UCCIF skills generate --host codex` and `codegraph status`.
5. A configured MCP entry is not proof the server or its tools loaded. Check the actual
   Codex tools; if not available, report this and use the verified CodeGraph CLI.
Do not change trust, install a language server, or promise a token footer.

Versions

Database snapshot: 13.11.2026 · package version 63998a61c46f (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

• 86init
  Initialize or refresh UCCIF project notes in Codex. Use for $uccif:init, initializing UCCIF, or updating project purpose and conventions. Not source changes.
• 90codegraph-usage
  How to use CodeGraph well — which tool answers which question, when to reach for it and when not, and the gotchas that trip agents up. Read before using CodeGraph tools in a project that has a .codegraph/ index, and whenever a CodeGraph call returns confusing or incomplete results.
• 86resume
  Resume work saved in UCCIF task memory in Codex. Use for $uccif:resume or a request to continue a recorded UCCIF task; recheck stale progress before editing.
• 100agent-eval
  Benchmark CodeGraph retrieval quality on a real codebase by comparing agent behavior with vs without CodeGraph. Use when the user runs /agent-eval or asks to test, benchmark, audit, or validate a codegraph version (the local dev build or a published npm version) against a language's repo.
• 100codegraph-context
  Use at the START of any coding session or before touching code in a project. Triggers on: "lavora su X", "modifica X", "aggiungi feature a X", "fix in X", any request that implies working inside a specific project folder. Ensures the CodeGraph index is fresh before writing a…
• 85codegraph-ast-grep
  Set up, update, or diagnose CodeGraph and ast-grep so coding agents can use semantic repository scope and structural syntax evidence automatically. Use when a repository needs an idempotent CodeGraph/ast-grep installation, stable tool and index migrations, MCP reconnection,…