Cursor Extension

The CodeLoop Cursor extension is the fastest way to enable always-on activation. It auto-pastes the User Rule, registers the global MCP server, and runs codeloop_init_project the first time you open a workspace — so the verify / diagnose / gate loop fires automatically without you typing anything.

What the extension does

Writes the global Cursor user rule to ~/.cursor/codeloop-user-rule.md and registers it under Settings > Rules > User Rules.
Adds the CodeLoop MCP server to ~/.cursor/mcp.json with merge-safe writing (your existing servers are preserved).
Auto-runs codeloop_init_project the first time you open a new workspace, so a fresh project is fully bootstrapped before the first agent message.
Surfaces a CodeLoop Doctor command in the command palette that runs the same checks as codeloop doctor inside the IDE.

Install

Once the listing is live, install from the Cursor or VS Code Marketplace (search codeloop). Until then, install the local VSIX:

# from a CodeLoop checkout
cd packages/cursor-extension
npm run package
cursor --install-extension ./codeloop-cursor-extension-*.vsix

Or run the bundled installer command — it pulls the latest VSIX, falls back to the marketplace once published, and prints a one-time copy / paste banner if the user-rule registration step needs your help:

npx codeloop install-cursor-extension

Verify the install

Run codeloop doctor from your terminal. Every check in the Always-on activation section should be green:

~/.cursor/codeloop-user-rule.md exists.
~/.cursor/mcp.json contains a codeloop server entry.
The Cursor user-rule banner is registered (the extension marks this in its workspace state).
Your project has .codeloop/config.json.

Troubleshoot

If the rule doesn't auto-paste on first run, paste the contents of ~/.cursor/codeloop-user-rule.md manually under Cursor > Settings > Rules > User Rules and restart Cursor. The most common cause is a previous Cursor session holding an older rule list — restart resolves it. See Troubleshooting for the full list of doctor diagnostics.

Settings & commands

Once installed, the extension exposes its surface under Cursor > Settings > Extensions > CodeLoop and through the command palette (Cmd/Ctrl+Shift+P):

Command	What it does
CodeLoop: Doctor	In-IDE wrapper around `npx codeloop doctor`. Same checks, same output, no terminal switch.
CodeLoop: Init project	Manually run `codeloop_init_project` for the active workspace.
CodeLoop: Re-paste User Rule	Reopens the User Rule banner in case the auto-paste was dismissed.
CodeLoop: Open dashboard	Spawns `npx codeloop dashboard` if not already running and opens it in the integrated browser.
CodeLoop: Open Tool reference	Jumps to /docs/tools in the integrated browser.

Telemetry

The extension itself sends zero telemetry. Any usage events come from the MCP server it registers, and they obey the same privacy contract documented in Security & data handling (counters only, never source / screenshots / logs).

Updating the extension

Once published to the Cursor / Open VSX marketplace the extension will auto-update on Cursor restart. Until then, npx codeloop install-cursor-extension always pulls the latest VSIX from the CodeLoop release page.