Frequently Asked Questions
Answers to common questions about CodeLoop. Can't find what you're looking for? Contact us.
General
What is CodeLoop?
CodeLoop is an automated verification tool that works inside AI coding agents like Cursor and Claude Code. It adds a verify-diagnose-fix loop to your AI-powered development workflow, so you don't have to manually test every change your AI agent makes.
Does CodeLoop replace my AI agent?
No. CodeLoop works alongside your AI agent. Your agent (Cursor/Claude Code) still writes and fixes code. CodeLoop provides the verification and quality assurance layer that tells the agent whether the code actually works.
Does CodeLoop use my AI tokens?
No. CodeLoop runs locally on your machine via the MCP server. It executes your existing build tools, test runners, and screenshot tools. Your AI agent uses its own LLM tokens for coding. CodeLoop adds zero additional AI compute cost.
What frameworks does CodeLoop support?
CodeLoop supports any project that has a build/test workflow. It has specialized support for Flutter, React, Next.js, Vue, Angular, Electron, and more. The verification runners are configurable for any tech stack.
Setup
How do I install CodeLoop?
Run "npx codeloop init" in your project directory. It auto-detects your project type, creates MCP config for your AI agent, and sets up rule files. The whole process takes under 2 minutes.
Do I need to install anything globally?
No. CodeLoop runs via npx, so it downloads on demand. You just need Node.js 18+ installed.
Can I use CodeLoop with both Cursor and Claude Code?
Yes. CodeLoop supports both agents and creates the appropriate config files for whichever one you use. You can even use it with both simultaneously on different projects.
Does CodeLoop work on Windows?
Yes. CodeLoop works on macOS, Windows, and Linux. The MCP server runs on Node.js, which is cross-platform.
Usage
What is a 'verification run'?
Each call to codeloop_verify counts as one verification run. This single call can include build, lint, test, and screenshot capture — all at once.
What is the confidence score?
The confidence score (0-100%) is a quantified measure of code quality based on build success, test pass rate, lint status, and absence of regressions. A score of 85%+ typically means the section is ready for human review.
Can CodeLoop build an entire app autonomously?
CodeLoop's multi-section orchestration feature allows your AI agent to build an app section-by-section, with each section going through the verify-diagnose-fix loop until it reaches high confidence. The agent continues to the next section without waiting for human input.
What happens if CodeLoop can't fix an issue?
CodeLoop doesn't fix issues directly — it diagnoses them and tells your AI agent what to fix. If the agent can't resolve an issue after multiple iterations, the gate check will flag it and recommend human review of specific items.
Billing
Is there a free trial?
Yes — 14 days, no credit card required. You get 200 verification runs, 100 visual reviews, and access to all tools.
Can I switch plans?
Yes. Upgrade or downgrade anytime from your dashboard. Changes take effect at the next billing period.
What happens when I hit my limit?
Tools will return a friendly message suggesting an upgrade. Your account and data remain intact. You can continue using CodeLoop immediately after upgrading.
Is there a refund policy?
Yes. Contact us within 7 days of subscription for a full refund.
Troubleshooting
My agent doesn't see CodeLoop tools
Make sure your MCP config file exists (.cursor/mcp.json or .claude/settings.local.json) and is valid JSON. Restart your AI agent after creating the config. Check that CODELOOP_API_KEY is set in your environment.
Verification is slow
Verification speed depends on your project's build and test times — CodeLoop just runs what you already have. You can speed things up by using test filters or disabling screenshots for non-UI changes.
I see 'API key invalid' errors
Check your key with 'echo $CODELOOP_API_KEY'. Verify it's correct in your dashboard. If your trial expired, upgrade to continue. The MCP server caches valid keys, so a brief network outage won't cause issues.