A walkthrough from installation to enforcement. Follow the steps in order — the whole thing takes about 15 minutes.
Search "Iris Code Health" in the Extensions panel (Ctrl+Shift+X / Cmd+Shift+X), or use the direct Marketplace link below. On a JetBrains IDE, search "Iris Code" in Settings → Plugins and restart the IDE after installing. Iris Code activates automatically when you open a JavaScript, TypeScript, Go, or Python file.
Iris Code — Code Health
marketplace.visualstudio.com · davidjaja.iris
Click the Iris Code icon in the Activity Bar to open the sidebar. Then open any .ts, .tsx, .js, .jsx, .go, or .py file. You'll see the health score, function list, complexity score, and any code smells or import issues in real time.
The Iris Code sidebar — populated the moment you open a supported file.
In VS Code, open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P) and run "Iris Code: Sign In" - your browser opens, authenticates, and redirects back with your license key, stored securely in VS Code's SecretStorage. In a JetBrains IDE, use Tools → Iris Code → Sign In; the key is stored once under your home directory and shared with the iris CLI, so one sign-in covers every host. No copy-pasting.
Back to your dashboardOpen Account -> Config in your dashboard to pick a preset and sync a .irisconfig.json to VS Code or a JetBrains IDE without touching a file manually. Free users can apply any preset (balanced, strict, legacy, security, typescript) and commit it so the whole team uses the same thresholds. Pro users get the full Config Studio - switch to Custom mode to override individual thresholds, retention controls, toggles, and severity rules.
{
"presetId": "balanced",
"minHealthScore": 75,
"complexityThreshold": 8,
"functionLengthThreshold": 60,
"trendRegressionThreshold": 5,
"gateBaselineMode": true,
"enableSecretsDetection": true,
"gateMaxSecrets": 0,
"ignoreFiles": [
"**/*.test.ts",
"**/generated/**"
]
}Run "Iris Code: Write Project Rules for AI Agents" from the Command Palette, or `iris rules` in a terminal. It turns your .irisconfig.json into instructions - file and function limits, your naming convention, what blocks a push - and writes them to AGENTS.md, CLAUDE.md, Cursor rules or Copilot instructions. Pick more than one if your team runs more than one agent: Claude Code reads only CLAUDE.md, while AGENTS.md is what Codex, Cursor and Copilot read. Nothing is analysed, nothing leaves your machine, and no AI model is involved. Commit the file so it applies to everyone, and every agent, working in the project.
Before installing a hook, open Gate Preview from the bottom of the File tab - it shows how your workspace scores against all six preset thresholds for free, with no enforcement. Once you're confident in the threshold, run "Iris Code: Install Git Hook" from the Command Palette. A build hook for npm prebuild, Go Makefile, and Python projects is also available.
$ git push origin main Iris Code: Checking health score... ✗ src/utils/format.ts — score 61 (threshold: 75) Iris Code: Push blocked. Fix failing files or lower your threshold. error: failed to push some refs to 'origin'
Iris Code is genuinely useful on the Free plan. Pro adds the features that matter for teams — enforcement, workspace analysis, and shared configuration.
Free
$0
Always free, no credit card
Pro
$6/mo
Cancel any time
Open VS Code or your JetBrains IDE, install Iris Code, and it will be in your sidebar the next time you open a file.
Install Iris Code, set a threshold, and make every change answer to the same deterministic rules. Source analysis runs locally. The same rules run in VS Code, JetBrains IDEs, the iris CLI, hooks, and CI.