CodeLoop

Quick Start

Get CodeLoop running in under 2 minutes. Choose the setup path that fits your workflow.

Path 1: Website Signup (Recommended)

  1. Sign up at codeloop.tech/signup — no credit card required.
  2. Copy your API keyfrom the post-signup screen (it's shown only once).
  3. Set the environment variable in your shell:
    # macOS / Linux — add to ~/.zshrc or ~/.bashrc
export CODELOOP_API_KEY="cl_live_your_key_here"

# Windows PowerShell — set as user env var
[System.Environment]::SetEnvironmentVariable("CODELOOP_API_KEY", "cl_live_your_key_here", "User")
  4. Initialize in your project:
    cd your-project
npx codeloop init

    This auto-detects your project type, creates the MCP config for Cursor or Claude Code, and sets up rule files.

Path 2: CLI Signup (Terminal-First)

Prefer doing everything from the terminal? No problem.

# Create your CodeLoop account
npx codeloop signup

# Follow the prompts: name, email, password
# Your API key will be displayed and saved automatically

# Then initialize in your project
cd your-project
npx codeloop init

Path 3: Agent-Guided Setup

If your AI agent (Cursor or Claude Code) recommends CodeLoop during a coding session, you can set it up right from the integrated terminal:

# Run in the integrated terminal when your agent suggests CodeLoop
npx codeloop init

# If you don't have an account yet, init will offer to create one
# Just follow the inline prompts

Verify It Works

After setup, verify CodeLoop is correctly configured:

  1. Check MCP config exists:
    # Cursor
cat .cursor/mcp.json

# Claude Code
cat .claude/settings.local.json
  2. Look for CodeLoop toolsin your AI agent's tool list. You should see tools like codeloop_verify, codeloop_diagnose, etc.
  3. Ask your agent: “Run codeloop_verify on this project” — the agent should call the tool and return structured results.

Next Steps