PluginPartly tested (needs an account)

Code map and task memory

uccif

Claude Code plugin that points Claude to a code map (CodeGraph) before it searches files, keeps a task record across turns, and adds rules by hooks.

Works with
Claude Code, Gemini CLI
Good for
Build an app, Everyone

What it does

UCCIF (Universal Claude Code Intelligence Framework) is a Claude Code plugin. You install it once, and it works in each repository you open.

It uses CodeGraph, a separate open-source tool, as a map of your code. Its hooks tell Claude to look code up in the map before it searches files with Grep or Read. This can save tokens on large projects.

It also keeps a task record. Your first edit opens a task, and the task survives new turns and /clear. You can ask Claude to continue the task later. From the map it can write project skills that describe your modules and how to fix bugs in them.

Optional extras: a line with the real token count after each reply (token_report), and /uccif:init, which writes short project notes.

Example prompts

  • "How does login work?"
  • "Where is the total price calculated?"
  • "What breaks if I change this component's props?"
  • "Continue yesterday's work"
  • "Did the hooks run today?"
  • "run uccif doctor"

How to install

/plugin marketplace add phongng255/uccif
/plugin install uccif@uccif

How to use it

Open a project and ask a code question. Set reply_language to en in /config first, or Claude replies in Vietnamese. If CodeGraph is missing, Claude asks once whether to install it.

Check it works

  1. Set reply_language to en in /config.
  2. Open a project and ask "How does login work?".
  3. If CodeGraph is missing, Claude asks once whether to install it. After a yes, restart Claude Code.
  4. Ask "run uccif doctor". OK is fine, WARN is worth a fix.

Common problems

Other assistants

  • Gemini CLI: gemini extensions install https://github.com/phongng255/uccif.git (guide). The author says this route has only been checked by automated tests. Since 18 June 2026 Gemini CLI does not work with personal Google accounts. It works with a company Gemini Code Assist Standard or Enterprise licence, a paid Gemini API key or Vertex AI.
  • Antigravity CLI (for personal Google accounts): agy plugin install https://github.com/phongng255/uccif/tree/main/plugins/uccif-antigravity (README). Use that exact link. Antigravity is not Gemini CLI.
  • Codex: a development preview only, not released.

What to watch out for

  • Default reply_language is vi (Vietnamese): set it to en in /config if you want English replies
  • 12 hooks run at session start, on each prompt, before Bash/Grep/Glob/Read, after edits, at stop, around compaction and for subagents; the author says each one exits 0 and does not block (strict_codegraph, off by default, is the one exception)
  • Adds its own CORE RULES to each session, for example: run commands yourself, use CodeGraph instead of Grep/Read, never state token counts, reply in the set language
  • On your yes, Claude runs npm install -g @colbymchenry/codegraph (or shows a curl | sh installer and asks first), runs codegraph init --yes and appends .codegraph/ to .gitignore
  • Offers once to install missing language servers with npm install -g (typescript-language-server, pyright)
  • Records the files you edit and compares git status at each turn end; writes task memory to .claude/uccif/.local/ and logs outside the repo
  • Writes project skills to .claude/skills/<project>-*; /uccif:init writes .claude/uccif/summary.md, a block in AGENTS.md and an @AGENTS.md line in CLAUDE.md, and runs your test runner's list command once
  • With auto_setup on (off by default), it indexes each project you open in a background process
  • Gemini CLI support is checked only by the author's automated tests, not in a real session

Licence and author

Licence
MIT
Author
phongng255
Source code
github.com/phongng255/uccif

How we tested it

We installed it on an empty test computer on 7 Nov 2026. Partly tested: installed in a clean test system, but its main features need an account or key we did not use.

Test level

Not installed or run. plugin.json sets token_report off by default, but the README and guide say on; we describe the plugin.json default.

Technical details of the test
Date
7 Nov 2026
Method
Reviewed by our team against the repository at 3848320 (plugin 1.3.3): README, docs/GUIDE.md, plugin.json, hooks.json, .mcp.json, .lsp.json, the three skills and the hook code.

Checked again on 7 Nov 2026

Alternatives

  • claude-mem — records what the agent did in past sessions and brings it back later
  • Planning with Files — keeps the plan and progress of a long task in plain files, without a code map

FAQ

  • Q: Does it block my tools? A: Not by default. Only the optional strict_codegraph refuses the first Read or Grep of source code in a turn, once, until Claude looks the code up in CodeGraph.
  • Q: Is CodeGraph required? A: No. Without it, Claude asks once. If you say no, Claude searches with Grep and does not ask again in that project.
  • Q: Does it send my code anywhere? A: The guide says UCCIF has no server and runs CodeGraph with telemetry off. We found no network code in the plugin. Your AI tool still sends the code it reads to its provider.
  • Q: What should I commit? A: .claude/uccif/ (notes and decisions) and the generated skills if you want to share them. Do not commit .codegraph/ or .claude/uccif/.local/.
  • Q: How do I remove it? A: Run claude plugin uninstall uccif@uccif. Then delete .codegraph/, the generated skills and the UCCIF block in AGENTS.md if you do not need them.

Sources

  • github.com/phongng255/uccif
  • github.com/phongng255/uccif/blob/3848320a1f9224db446259fbb8be80ab27a4652c/README.md
  • github.com/phongng255/uccif/blob/3848320a1f9224db446259fbb8be80ab27a4652c/plugins/uccif/.claude-plugin/plugin.json
  • github.com/phongng255/uccif/blob/3848320a1f9224db446259fbb8be80ab27a4652c/plugins/uccif/hooks/hooks.json
  • github.com/phongng255/uccif/blob/3848320a1f9224db446259fbb8be80ab27a4652c/plugins/uccif/skills/codegraph/SKILL.md
  • github.com/phongng255/uccif/blob/3848320a1f9224db446259fbb8be80ab27a4652c/plugins/uccif/uccif_lib/rules.py
  • github.com/phongng255/uccif/blob/3848320a1f9224db446259fbb8be80ab27a4652c/docs/GUIDE.md