Cursor-style Debug composer mode
Composer Debug is ACE’s Cursor-like debug loop: investigate with live session context, then Review & Apply a minimal fix. It is not silent Agent auto-apply, and it is not Ask-only.
What it does
- Selecting Debug focuses the Debug sidebar and status tip.
- AI requests attach
context.debug_sessionwhen available:console_tail,stack,paused_file/paused_linebreakpoints,variables,runtime,target_path
- Server prompt (
COMPOSER MODE: DEBUG) asks for hypotheses → root cause → minimal edits. - File tools allowed: read + single-file edits (
edit_file,propose_edit,write_full_file,create_file). Nocreate_multiple_files. - Client: Review & Apply enabled; auto-apply skipped in Debug.
- Large scaffolds (“full ecommerce app”, “from scratch”) → switch-to-Agent CTA.
Ask ACE wiring
| Source | Outcome |
|---|---|
| Debug Ask ACE + failure signals | Composer Debug, session context, Review & Apply |
| Run Ask ACE + non-zero exit | Composer Agent (if plan allows) |
| Clean Run/Debug output | Composer Ask, read-only summary |
Manual test checklist
Use desktop-ide/samples/phase3-run-debug/ (debug-me.js, fail-on-purpose.js, hello.js).
- Composer → Debug → Debug sidebar opens; tip mentions Review & Apply.
- Open
debug-me.js, set a breakpoint, Start, hit pause → Ask in Debug about the bug → reply uses console/pause context. - Open
fail-on-purpose.js, Debug Start (or Run) until error → Ask ACE → mode stays Debug → Review card for a small fix → Apply → re-run. - Open
hello.js, Run to exit 0 → Ask ACE → Ask mode, no disk writes. - In Debug, prompt “build a full ecommerce app from scratch” → Agent switch CTA (no scaffold actions).
- Confirm Agent still auto-applies when that setting is on; Debug never auto-applies.
Related docs
ask-vs-agent.md— mode gate tablerun-debug.md— Run/Debug panels + F5
