Getting started
1
Install the extension
Search for Iris Code in the Extensions view, or install
davidjaja.iris-code from the Marketplace.2
Open a project
Iris Code activates on JavaScript, TypeScript, JSX, TSX, Vue, Svelte, Go, Python, Ruby, C#, Java and Rust files, and on any workspace containing a
.csproj. Its icon appears in the Activity Bar.3
Open a file
The score, metrics and findings appear in the sidebar immediately. No configuration is needed to start.
Signing in
Run Iris Code: Sign In from the command palette. Your browser opens, you approve the sign-in, and the licence key is sent back to the editor and kept in VS Code’s secure storage. That does not sign in the CLI, theiris commands you run in a terminal. Hooks and CI use the CLI, so run iris auth login as well, which writes ~/.iris/credentials.
Code Lens
Code Lens is a small line of grey text that VS Code shows above a piece of code. Iris Code uses it to point out functions longer than your configured limit, and certain leftover debug prints. The hints depend on the language, so you only see ones that apply to the file you are editing.Status bar
The status bar, along the bottom of the window, shows three figures for the file you have open: health score, line count and function count. It changes colour when the score or complexity crosses a limit, so you notice without having to look.Detached panel
The sidebar is narrow. The detached panel moves Iris Code into a full editor column beside your code, which is easier for reading a long list of findings. Click the pop-out icon in the sidebar title bar, or run Iris Code: Open in Panel. The same action closes it.- Updates automatically as you switch files or save.
- Two-column layout at 700px or wider: stats on the left, findings on the right.
- The sidebar shows a placeholder while the panel is open, so the same data is never displayed twice.
- Findings stay clickable, opening the exact source line.
The detached panel is available on all plans, as are Code Lens and the status bar.
What you get
VS Code has every Iris Code editor feature:- the sidebar with Home, Review, Improve, Explore and Configure, plus the File, Folder, Workspace, Findings and TODOs review scopes
- inline diagnostics (underlines in the code) and quick fixes
- the onboarding tour and the Explorer file-naming badge
- every table view and the duplicate diff
- Review My Changes
- hook and CI installation
- dashboard config sync over the
iris-code://deep link
Reporting a problem
When an Iris Code action fails, such as a workspace scan, the error notification has two buttons:- Show details opens the Iris Code output panel, where every failure is logged with the time, the action and the full error.
- Report problem opens a report form on iriscode.co with a short summary already filled in: the Iris Code and VS Code versions, your operating system, the action and the error message.
~ and <workspace>. The summary travels in the part of the link that browsers do not send to a server. Nothing reaches Iris Code until you review it, add what you were doing and press Send report, and you can edit or delete any of it first.
Settings
Iris Code reads.irisconfig.json, the project’s settings file, first, and then your VS Code settings. Put anything a teammate should also get in the project file, since it is committed with the repository.
See Configuration for the fields, and VS Code settings for the editor-level toggles.