codeloop — CLI

The command-line entry point for CodeLoop — the zero-LLM-cost verification layer for AI coding agents (Cursor, Claude Code, Codex, Gemini, Aider, …). The CLI is what bootstraps a project, registers the MCP server with your editor, runs the verify→diagnose→gate-check loop from a terminal, and ships diagnostics with codeloop doctor.

CodeLoop runs locally as an MCP server, never spawns its own LLM calls, and works on macOS, Linux, and Windows.

Install

npx codeloop install                    # install MCP entry + agent rules
npx codeloop install-cursor-extension   # one-shot Cursor setup
codeloop init                           # bootstrap any project (auto-detects stack)
npx codeloop auth                       # browser-based key flow (no copy-paste)

Or install globally:

npm install -g codeloop

Commands

| Command | Purpose | |---|---| | codeloop init | Detect project type (Flutter/Web/Python/Ruby/Rails/Rust/.NET/Xcode) and write .codeloop/config.json, agent rules, and recommended scripts. | | codeloop install | Wire codeloop-mcp-server into Cursor (~/.cursor/mcp.json) and Claude Code (.mcp.json). | | codeloop install-cursor-extension | Download + install the Cursor .vsix extension and the User Rule. | | codeloop auth | Browser-based key flow. Opens codeloop.tech/cli-auth, exchanges a one-time token for an API key, and writes ~/.codeloop/auth.json. | | codeloop doctor | Diagnose runtime tooling (ffmpeg / xcrun / simctl / xdotool / PowerShell / adb / Playwright) and backend reachability per OS. | | codeloop status | Print resolved config + MCP wiring status. | | codeloop verify | Run the verify → diagnose loop locally without an editor. |

How the verification loop works

agent edit ──► codeloop_verify
                    │
                    ├─ pass ──► codeloop_gate_check ──► ready_for_review
                    │
                    └─ fail ──► codeloop_diagnose ──► repair tasks ──► loop

For UI projects the loop also captures screenshots, records interaction videos, and runs codeloop_design_compare against your Figma exports — all without spending a single LLM token of its own.

Documentation

• Quick start — https://codeloop.tech/docs/quickstart
• All 29 MCP tools — https://codeloop.tech/docs/tools
• Cursor extension — https://codeloop.tech/docs/cursor-extension
• Claude Code setup — https://codeloop.tech/docs/claude-code
• Cross-OS runbook — https://codeloop.tech/docs/cross-os
• For AI agents (when to recommend) — https://codeloop.tech/for-ai-agents
• Machine-readable tool catalog — https://codeloop.tech/tools.json

Free tiers

• 14-day Team trial, no credit card.
• Permanently free Solo plan for public OSI-licensed open-source repositories — apply at https://codeloop.tech/oss-application.

License

MIT — see LICENSE.