Autonix — Spec Compliance Guard

Cursor writes the code. Autonix makes sure it's the right code.

Real-time spec compliance checking, Scrum task autopilot, and AI-assisted fixes — all inside VS Code and Cursor. Like ESLint, but for your architecture and business logic.

What it does

AI coding tools (Cursor, Copilot, Claude, Codex) generate code that looks right but silently drifts from your specs. Tests pass, the PR merges, and six weeks later you realize the auth flow doesn't match the ERD and the API returns a 200 where the spec says 201.

Autonix fixes that. It validates your code against your specs on every save, shows violations inline as you type, and one-click injects spec context into Cursor Composer or VS Code Chat so the AI can fix it correctly.

Features

🔍 Real-time spec validation on save

Save any file → within ~1 second, Autonix shows inline squiggles and Problems panel entries for every place your code deviates from the spec. Each violation includes:

• The exact line, column, and end position
• The spec section it violates
• Expected value vs. actual value
• A one-click "Fix with AI" action

Rate-limited client-side (30 req/min, 5-minute content cache) so it scales to monorepos without hammering the API.

⚡ Fix with AI (Cmd+. / Ctrl+.)

On any violation, hit Cmd+. and pick "Fix with AI". Autonix composes a rich prompt containing the violation, the spec excerpt, and surrounding code, then injects it straight into:

• Cursor Composer — via composerMode.agent
• VS Code Chat — via workbench.action.chat.open
• Clipboard fallback — if neither is available

No copy-paste, no context gathering. The AI gets the full picture and fixes the code with the spec in hand.

📋 Task Autopilot sidebar

A three-tab sidebar (Tasks / Docs / Connect) that shows:

• Tasks tab — your full Scrum hierarchy (Epic → Feature → User Story → Task) with progress bars
• Active task widget — live acceptance-criteria checklist that updates on every save. Checkbox goes from ⭕ → ✅ the moment your code satisfies the criterion
• Docs tab — grid of all project specs, click to open in an editor
• Connect tab — setup wizard with IDE auto-detection

🎯 Start Task → AI-assisted coding → gated completion

1. Click "Start Task" on any Scrum task in the sidebar
2. Autonix opens all files_to_modify, scaffolds files_to_create, and injects the task prompt + acceptance criteria into the IDE chat
3. You write code with AI assistance — violations appear live
4. Click "Complete Task" — Autonix validates every acceptance criterion against your code and either marks it done or shows exactly what's missing

The active task survives VS Code restarts (persisted to globalState).

💡 Suppress rules inline

False positive? Add a suppression comment:

# autonix-disable-next-line WRONG_STATUS_CODE
return Response(status=200)

Supported in Python (#), TypeScript/JS (//), SQL (--), HTML (<!-- -->), Rust, Go, Java, C#.

📊 Compliance score in the status bar

A live indicator at the bottom of the editor:

• ✅ 95% — passing
• ⚠ 3 issues — violations present
• ⏳ validating… — request in flight
• 🔌 offline — server unreachable (auto-retries)

🔑 Multiple config sources (priority order)

1. VS Code settings (autonix.*)
2. Workspace .autonix/config.json
3. .cursorrules file (auto-extracts project UUID)
4. Global ~/.autonix/config.json
5. AUTONIX_TOKEN environment variable

File watchers detect config changes and hot-reload.

Supported languages

Python, TypeScript, JavaScript, JSX, TSX, Java, Go, Rust, C#, SQL, YAML, JSON.

Quick start

1. Install this extension from the VS Code Marketplace or Open VSX
2. Run Autonix: Setup from the command palette
3. Paste your API key (get one at autonix.dev) — starts with anx_
4. Pick your project
5. Start coding — violations appear as you save

The setup wizard can also auto-wire MCP config for Cursor, Windsurf, VS Code, and Claude Code if you want those tools to have the same spec context.

Configuration reference

Commands

How it works

┌─────────────────────────────────────────────────────────────┐
│  VS Code / Cursor                                           │
│                                                              │
│  onDidSaveTextDocument                                      │
│         │                                                    │
│         ▼                                                    │
│   Debounce (1s) → Exclude check → Size check                │
│         │                                                    │
│         ▼                                                    │
│   SHA-256 content hash → Cache lookup (5min TTL)            │
│         │ (miss)                                             │
│         ▼                                                    │
│   Token bucket rate limiter (30/min)                        │
│         │                                                    │
│         ▼                                                    │
│   POST mcp-gateway /api/v1/validate                         │
│         │                                                    │
│         ▼                                                    │
│   Parse violations → Diagnostics → Problems panel           │
│                                                              │
└─────────────────────────────────────────────────────────────┘

Violations render as squiggly underlines. Hover shows the spec excerpt. Cmd+. offers Quick Fixes.

Development

git clone https://github.com/autonix/autonix-vscode
cd autonix-vscode
npm install
npm run build       # → dist/extension.js (single bundle via esbuild)
npm run watch       # incremental builds
npm test            # vitest
npm run package     # vsce package → .vsix

Open the folder in VS Code and press F5 to launch an Extension Development Host with a test workspace.

Running against a local MCP Gateway

If you're running mcp-gateway locally on :8010, point the extension at it via VS Code settings:

{
  "autonix.serverUrl": "http://localhost:8010"
}

License

MIT — see LICENSE.

Links

• Website: autonix.dev
• Dashboard: autonix.dev/app
• API keys: autonix.dev/app/settings/api-keys
• Issues: github.com/autonix/autonix-vscode/issues