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@uccifHow 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
- Set
reply_languagetoenin/config. - Open a project and ask "How does login work?".
- If CodeGraph is missing, Claude asks once whether to install it. After a yes, restart Claude Code.
- Ask "run uccif doctor".
OKis fine,WARNis worth a fix.
Common problems
- Claude replies in Vietnamese — the default
reply_languageisvi. Set it toenin/config— https://github.com/phongng255/uccif - No
codegraph_exploretool — restart Claude Code after the CodeGraph install, then ask Claude to runuccif codegraph— https://github.com/phongng255/uccif/blob/main/docs/GUIDE.md - CodeGraph tools appear twice — do not also run
codegraph install --target=claude, because the plugin already declares the server — https://github.com/phongng255/uccif python3: command not found— the hooks need Python 3.8+ and git — https://github.com/phongng255/uccif/blob/main/docs/GUIDE.md- No token line —
token_reportis off. Turn it on in/config— https://github.com/phongng255/uccif/blob/main/docs/GUIDE.md - An update does not show — restart Claude Code. If that does not help, uninstall and install the plugin again — https://github.com/phongng255/uccif
- Windows — the author tests Windows hooks in CI only, not yet in a real Claude Code session — https://github.com/phongng255/uccif
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.
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_codegraphrefuses 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 inAGENTS.mdif 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