Inspecta IDE Integration

Connects the Inspecta Chrome extension to Cursor, VS Code (GitHub Copilot), and compatible editors so visual CSS edits can be sent straight into your AI coding agent.

What it does

• Runs a small local WebSocket bridge (default port 8080)
• Receives CSS change / overview prompts from Inspecta in the browser
• Opens them in Cursor Composer or GitHub Copilot Chat
• Optionally notifies Inspecta when the AI finishes applying changes

From 1.0.3, the Chrome extension builds the full agent prompt (including instructions and discovered bridge port) and this extension opens it in your AI agent as-is.

Requirements

• Inspecta Chrome extension
• Cursor, VS Code, VSCodium, or Windsurf

Install

From a .vsix (sideload)

1. Download inspecta-ide-integration-1.0.3.vsix
2. Command Palette → Extensions: Install from VSIX…
3. Select the file, then Developer: Reload Window
4. Command Palette → Inspecta: Start Server (or use the status bar)

From a marketplace (coming with this release)

Search for Inspecta IDE Integration on Open VSX (Cursor / VSCodium / Windsurf) or the VS Code Marketplace.

Pair with Inspecta

1. Start the Inspecta server in the IDE
2. Open a page with the Inspecta Chrome extension
3. Make CSS changes → Send to IDE / Send to Cursor
4. Accept the agent prompt in your IDE

Privacy & security

• The bridge binds to 127.0.0.1 only — it is not exposed on the network
• Browser ↔ extension traffic is token-paired (bridgeAuth); unsolicited clients are rejected
• Prompt data stays on your machine (browser → local extension → your IDE agent)
• No telemetry is collected by this extension

Commands

Settings

• inspecta-ide.serverPort — bridge port (default 8080)
• inspecta-ide.autoStart — start server when the IDE opens (default false)
• inspecta-ide.implementationIdleCompleteMs — idle fallback for “implementation complete”

Protocol note (1.0.3)

Send-to-IDE payloads use a browser-built prompt string (ordered JSON: static instructions first, completion_notify last). The extension renders that string verbatim.

More docs

Internal docs live in the monorepo under all-md/ide-extension/ (quick start, installation, release plans).