ireview
AI-to-AI code review router. Any OpenAI-compatible model reviews your code. No Codex CLI or Node.js required.
Open source Repository Open in the app JSON README (API)
About
AI-to-AI code review router. Any OpenAI-compatible model reviews your code. No Codex CLI or Node.js required.
Details
- Kind
- Plugins
- Topic
- Developer tools
- Publisher
- ilang-ai
- Origin
- marketplace
- Category
- ferramentas
- Stars
- 1
- Last push
- 2026-07-17T18:18:56Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-08-30 01:48:58
- Updated
- 2026-08-30 01:48:58
- Origin id
ilang-ai/ireview/ireview
README
# iReview
> **AI-to-AI code review, powered by I-Lang protocol.**
> Any model reviews your code. Structured instructions in, structured findings out.
>
> I-Lang is the first protocol to formally map Greek mathematical symbols (Σ, Δ, φ, λ, Ω, ∇, μ, Π, ψ, ξ, ζ, θ, ∂) as primitive verbs for AI-to-AI communication, and the first to define a computable vector space for AI judgment (11 dimensions, 4 axioms).
[](LICENSE)
[](https://ilang.ai)
[](https://github.com/ilang-ai/ilang-spec)
---
## Why
Every AI-to-AI code review tool today sends English prose between models. "You are a senior code reviewer. Please review this diff..." — and the response is unstructured text that has to be guessed and parsed.
iReview uses **I-Lang v5.0** as the communication protocol between models. Claude Code sends structured instructions:
```ilang
[EVAL:@DIFF|focus=security,bugs]=>[SCAN]=>[CLSF|typ=severity]=>[OUT]
```
The review model returns structured declarations:
```ilang
::REVIEW{id:20260430|model:deepseek-chat|decision:fail}
::FINDING{id:IR-001|severity:critical|conf:0.92|file:src/auth.ts|line:42}
issue: JWT token accessed before validation
fix: Add token.verify() before accessing claims
::END{REVIEW}
```
Two AIs speaking a protocol. Not prose. Not guesswork. Parseable, repeatable, model-agnostic.
| | iReview | codex-plugin-cc |
|---|---|---|
| Install | One config file | Codex CLI + ChatGPT login |
| Models | Any OpenAI-compatible API | OpenAI only |
| Dependencies | Git + Bash + Python3 | Node.js 18.18+ + Codex CLI |
| Review modes | Standard + Adversarial | Standard + Adversarial + Background |
| Multi-model | Yes (chain security→perf→arch) | No |
| Protocol | I-Lang structured declarations | English prose |
| Cross-tool | CC + Cursor + Codex + Copilot + Gemini | Claude Code only |
| Stop gate | Diff-hash aware (no infinite loop) | Full state machine |
## Requirements
- `python3` (for reliable JSON handling in API calls)
- `git`
- `curl` or `urllib` (Python stdlib)
## Install (seconds)
```bash
/plugin marketplace add ilang-ai/iReview
/plugin install ireview@ireview-marketplace
```
Create your config:
```bash
cp .ireview.example.json .ireview.json
# Set model and api_key — two fields, done
```
Or run `/ireview:setup` for interactive configuration.
## Config
**Recommended provider: DeepSeek official** ([platform.deepseek.com](https://platform.deepseek.com)) — no credit card required, just register, top up a few dollars, create an API key, and paste it in. You apply for your own key; it stays yours.
1. Register at [platform.deepseek.com](https://platform.deepseek.com)（注册,不需要绑卡）
2. Top up（充值,几块钱就能用很久 — review calls are cheap）
3. Create an API key（创建 API key）
4. Paste it into `api_key` below（把 key 填进配置）
```json
{
"model": "deepseek-chat",
"api_key": "sk-your-own-key-here",
"base_url": "https://api.deepseek.com/v1",
"focus": ["bugs", "security"],
"auto_review": false
}
```
API key priority: `CLAUDE_PLUGIN_OPTION_API_KEY` > `IREVIEW_API_KEY` env var > `api_key` field in config.
Any other OpenAI-compatible endpoint also works (OpenAI, OpenRouter, local Ollama, …) — set `model` and `base_url` accordingly. **Change model = change one line.**
## Commands
```bash
/ireview:review # Review uncommitted changes
/ireview:review --base main # Review branch vs main
/ireview:review --full # Run all .ireview-*.json configs
/ireview:adversarial # Devil's advocate review
/ireview:setup # Interactive configuration
/ireview:status # Review history and unresolved findings
/ireview:result # Show latest review details
/ireview:cancel # Cancel pending review, allow stop
```
## Auto Review Gate
Set `"auto_review": true` in config. When the session stops:
1. Stop hook detects file changes and computes diff hash
2. If this diff wasn't reviewed yet: blocks stop with instructions
3. You run `/ireview:review` — review executes, results saved
4. On next stop: diff hash matches passed review — stop allowed
**No infinite loops.** Diff-hash tracking ensures the same changes aren't re-reviewed.
## Multi-Model Review
```bash
echo '{"model":"gpt-4o","api_key":"sk-xxx","base_url":"https://api.openai.com/v1","focus":["security"]}' > .ireview-security.json
echo '{"model":"deepseek-chat","api_key":"sk-xxx","base_url":"https://api.deepseek.com/v1","focus":["performance"]}' > .ireview-perf.json
```
`/ireview:review --full` — runs all configs. Each produces its own review file.
## Architecture
```
You ──→ Claude Code ──I-Lang──→ Review Model ──I-Lang──→ Claude Code ──→ You
(implementer) (reviewer) (presents findings)
```
```
hooks/stop-gate.sh ← Fast gating. Checks diff hash, blocks or allows.
scripts/call-api.py ← I-Lang protocol layer. Sends I-Lang instructions,
parses I-Lang responses. Falls back to JSON/text.
commands/*.md ← Slash commands. Orchestrate the review flow.
skills/ireview/SKILL.md ← Protocol definition. I-Lang request/response formats.
```
The key insight: API calls go through `call-api.py` which sends I-Lang instructions as system prompts and parses `::REVIEW{}`/`::FINDING{}` responses. Models that understand I-Lang return structured declarations. Models that don't return JSON or text, and the script handles the fallback. Either way, the protocol is the interface.
## Works Across Tools
| Tool | File | Hook support |
|---|---|---|
| Claude Code | `CLAUDE.md` | Full (stop gate + commands) |
| Cursor | `.cursorrules` | Manual review only |
| Codex | `AGENTS.md` | Manual review only |
| Copilot | `.github/copilot-instructions.md` | Manual review only |
| Gemini CLI | `GEMINI.md` | Manual review only |
## Privacy
Your code goes to whatever API you configure. iReview collects nothing. For private code, use local Ollama.
Add `.ireview.json` to `.gitignore` — it contains your API key.
## License
MIT
---
<sub>Built by <a href="https://ilang.ai">I-Lang Protocol</a> · The native language of artificial intelligence</sub>