codeloop_self_test
Synthetic pre-flight diagnostic (added in 0.1.49). Walks every critical CodeLoop precondition for the current workspace in under a second: workspace exists, .codeloop/config.json present, platform detection, desktop-app honesty mode, evidence.target_app set when desktopAppMode is on, PNG decoder skip path, and DPI-aware coordinate translation. Run this as the FIRST MCP call on any new project — it catches project-shaped issues (missing init, unset target_app on a desktop UI, miscalibrated coordinates) before a full verify run discovers them.
When to use codeloop_self_test
Use `codeloop_self_test` when your AI agent needs to synthetic pre-flight diagnostic (added in 0.1.49). walks every critical codeloop precondition for the current workspace in under a second: workspace exists, .codeloop/config.json present, platform detection, desktop-app honesty mode, evidence.target_app set when desktopappmode is on, png decoder skip path, and dpi-aware coordinate translation. run this as the first mcp call on any new project — it catches project-shaped issues (missing init, unset target_app on a desktop ui, miscalibrated coordinates) before a full verify run discovers them.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| project_dir | string | no | Project root (auto-discovered if omitted). |
What you get back
{ ok, checks: [{ id, ok, value?, reason? }], next_step }
FAQ
What does codeloop_self_test do?
Synthetic pre-flight diagnostic (added in 0.1.49). Walks every critical CodeLoop precondition for the current workspace in under a second: workspace exists, .codeloop/config.json present, platform detection, desktop-app honesty mode, evidence.target_app set when desktopAppMode is on, PNG decoder skip path, and DPI-aware coordinate translation. Run this as the FIRST MCP call on any new project — it catches project-shaped issues (missing init, unset target_app on a desktop UI, miscalibrated coordinates) before a full verify run discovers them.
When should an AI agent call codeloop_self_test?
Use `codeloop_self_test` when your AI agent needs to synthetic pre-flight diagnostic (added in 0.1.49). walks every critical codeloop precondition for the current workspace in under a second: workspace exists, .codeloop/config.json present, platform detection, desktop-app honesty mode, evidence.target_app set when desktopappmode is on, png decoder skip path, and dpi-aware coordinate translation. run this as the first mcp call on any new project — it catches project-shaped issues (missing init, unset target_app on a desktop ui, miscalibrated coordinates) before a full verify run discovers them.
What does codeloop_self_test return?
{ ok, checks: [{ id, ok, value?, reason? }], next_step }
Is codeloop_self_test part of the CodeLoop MCP server?
Yes. CodeLoop ships as an MCP server installed via `npx codeloop init`. Cursor and Claude Code call it automatically once the User Rule (Cursor) or CLAUDE.md (Claude Code) is in place.