Skip to main content
Iris is a VS Code extension and CLI tool that enforces code health locally — no analysis backend, no AI, and no source-code upload. It scores every file you open or save on a 0–100 health scale, surfaces blockers, code smells, and hardcoded secrets directly in the sidebar, and lets you block pushes or builds that fall below a threshold you set. From a single file to an entire workspace, Iris makes quality visible while you write code and enforceable before anything reaches your team.

​
What Iris Does

Iris continuously monitors the files you work on and the projects you manage, giving you four interconnected layers of insight: Health scores — every supported file receives a 0–100 composite score on every save, penalising long functions, deep nesting, debug prints, magic numbers, and secrets. The score updates instantly; no manual trigger required. Code smells — Iris detects TODOs, unused code, magic numbers, debug print statements, and long parameter lists across all supported languages. Every finding is clickable and jumps you directly to the relevant line. Secrets detection — hardcoded credentials are flagged with a masked preview in the sidebar before they can ship. Secrets detection is free on all plans and works without any configuration. Enforcement — Gate Preview lets you preview your enforcement posture against five preset thresholds before installing a single hook. When you’re ready, a git pre-push hook or build hook blocks files that fall below your chosen minimum health score. The same threshold can also be enforced in CI via iris gate.

​
How It Works

Iris runs entirely on your machine. Analysis is in-process — your source code never leaves your editor to reach an analysis backend, and no AI model processes your files. The only network calls Iris makes are limited account, billing, and product-use events required for licensing. This means:
  • Instant feedback — analysis runs in milliseconds on every save, with no round-trip latency
  • Offline capable — file analysis and CLI commands work without an internet connection
  • Private by design — proprietary code, secrets, and unreleased features stay on your machine

​
Supported Languages

Iris provides full analysis for four languages:
LanguageFile extensionsNotes
TypeScript.ts, .tsxIncludes any usage, @ts-ignore, non-null assertions, and missing return types
JavaScript.js, .jsxFull smell and complexity analysis; unused import detection included
Go.goMethod and function detection, go.mod unused package audit, vendor/ skipped automatically
Python.pydef declarations, requirements.txt / pyproject.toml package audit, .venv skipped automatically

​
Free vs Pro

Gate Preview, file scoring, secrets detection, and preset configs are free forever. Pro turns that signal into a hard gate — adding workspace scans, git and build hooks, drilldowns, custom rules, and the full CLI suite.

Free — $0/month

  • File analysis: health score, complexity, and functions
  • TypeScript-specific metrics
  • Code smell detection
  • Hardcoded secrets detection
  • Inline diagnostics (squiggles + Problems panel)
  • Status bar and Code Lens overlays
  • Detached panel and HTML report export
  • Health score trend tracking (2 snapshots)
  • .irisconfig.json preset configs (presetId)
  • Gate Preview — read-only enforcement posture check
  • CLI: iris check (single file), iris secrets, iris report, iris hook status, iris config

Pro — $6/month

  • Everything in Free
  • Workspace and folder analysis
  • Gate Preview drilldown — see exactly which files fail each preset
  • Git pre-push hook enforcement
  • Build hook enforcement
  • Dependents table with version audit and CVE scan
  • Issues tab with blocker and warning filters
  • TODOs tab aggregation
  • Clickable jump-to-line on all findings
  • Custom .irisconfig.json threshold overrides
  • Custom enforcement limits — block on secret count, complexity ceiling, file size, or smell density
  • Custom scoring weights per finding type
  • Config Studio — build, preview, and sync configs visually
  • Unlimited trend history
  • Full CLI suite: iris gate, iris deps, iris todos, iris hook install, and more
  • Account Insights dashboard
Every new account includes a 14-day free trial of Iris Pro — no credit card required. You get full access to workspace scans, enforcement hooks, and the complete CLI suite. After 14 days the account reverts to Free unless you subscribe. Ready to try it? Follow the Quick Start to go from install to first scan in under two minutes.