Your editor (IDE)

VS Code extension

Audit the spec open in your editor and see findings as inline squiggles.

The CVAI Spec Audit extension submits your active markdown file, then renders each flagged claim as an editor diagnostic anchored to the exact line.

Inline diagnostics with distortion type and calibration gap.

Developer gate (strong / usable / weak) in the status bar.

One click opens the full report in your browser.

Best for: Developers who want quality feedback without leaving VS Code.

Get started

Follow these steps to get up and running.

1

Install the extension

Build a .vsix from source and install it, or use "Install from VSIX..." in VS Code.

# In the vscode-extension/ folder
npm install
npm run package   # writes cvai-spec-audit-<version>.vsix

# Install it
code --install-extension cvai-spec-audit-<version>.vsix
2

Set your API key

From the Command Palette, run "CVAI: Set API key" and paste your cvai_ak_ key.

3

Audit a file

Open a spec or task-plan markdown file and run "CVAI: Audit this spec".

4

(Optional) Point at another instance

Set cvaiAudit.apiBaseUrl for a staging or self-hosted instance (default: https://communityvision.ai).

VS Code extension — frequently asked questions

Can CVAI audit a spec directly inside VS Code?

Yes. The CVAI Spec Audit extension submits your active markdown file and renders each flagged claim as an inline editor diagnostic anchored to the exact line, with the developer gate (strong, usable, or weak) in the status bar. Run "CVAI: Set API key" once, then "CVAI: Audit this spec".

Can I point the VS Code extension at a self-hosted CVAI instance?

Yes. Set the cvaiAudit.apiBaseUrl setting to your staging or self-hosted instance; it defaults to https://communityvision.ai.