Iris — Code Health for VS Code
Static code insights for JavaScript, TypeScript, Go, and Python. No AI, no backend, no telemetry. Everything runs locally.
Install from Marketplace · Documentation · iriscode.co
What Iris does
Iris analyses your code as you work — every file open and save triggers a full analysis. The sidebar shows:
- Health score — 0–100 composite score per file and workspace
- Complexity score — 1–10 based on function density, nesting, and control flow
- Function list — every function with line number, clickable to jump to source
- Code smells — console.log, magic numbers, TODOs, long parameter lists, unused variables
- TypeScript metrics — any usages, @ts-ignore count, non-null assertions, missing return types
- Workspace analysis — aggregate stats, file type breakdown, largest/most complex files, unused packages
- Problems tab — all warnings across the workspace in one place, each clickable
- TODOs tab — all TODO/FIXME/HACK comments aggregated, each clickable
Supported languages
| Language |
File analysis |
Workspace |
Unused packages |
| TypeScript / TSX |
✓ |
✓ |
✓ (package.json) |
| JavaScript / JSX |
✓ |
✓ |
✓ (package.json) |
| Go |
✓ |
✓ |
✓ (go.mod) |
| Python |
✓ |
✓ |
✓ (requirements.txt / pyproject.toml) |
Free vs Pro
| Feature |
Free |
Pro |
| File analysis (health score, complexity, functions) |
✓ |
✓ |
| TypeScript metrics |
✓ |
✓ |
| Code smell detection |
✓ |
✓ |
| Status bar + Code Lens |
✓ |
✓ |
| Workspace analysis |
— |
✓ |
| Folder analysis |
— |
✓ |
| Problems tab |
— |
✓ |
| TODOs aggregation |
— |
✓ |
| Clickable jump-to-line on all findings |
— |
✓ |
| .irisconfig.json team config |
— |
✓ |
Pro is $6/month globally. Nigerian developers get a launch price of ₦2,000/month (early adopter rate, locks in forever).
Get Pro at iriscode.co
Quick start
- Install Iris from the marketplace
- Open any JS, TS, Go, or Python file — the sidebar populates instantly
- Run
Iris: Sign In from the command palette to activate your account
- Run
Iris: Analyse Workspace to scan your entire project
Configuration
Drop a .irisconfig.json at your project root and commit it — your whole team runs Iris with the same thresholds:
{
"functionLengthThreshold": 60,
"fileLengthThreshold": 400,
"enableConsoleLogWarnings": false,
"ignoreFiles": ["**/*.test.ts", "**/generated/**"],
"ignoreFunctions": ["main", "handler"],
"severityOverrides": {
"no-exports": "warning",
"file-too-long": "warning"
}
}
.irisconfig.json takes priority over VS Code settings. Only include the keys you want to override.
Commands
| Command |
Description |
Iris: Analyse Current File |
Re-analyse the active file |
Iris: Analyse Workspace |
Scan all supported files in the workspace |
Iris: Analyse This File |
Right-click a file in Explorer |
Iris: Analyse This Folder |
Right-click a folder in Explorer |
Iris: Analyse Current Folder |
Scan the folder of the currently open file |
Iris: Sign In |
Connect your account to activate Pro |
Iris: Sign Out |
Remove stored license key |
Iris: Check License Status |
Show whether your Pro license is active |
Privacy
Your code never leaves your machine. All analysis runs entirely locally with no network requests. Iris makes requests only for account management (sign-in, license validation) and sends anonymous usage signals (which features you use, never your code). No code, file contents, or project structure is ever transmitted.
Documentation · Pricing · Support
