Build with FreeCoder

Plan mode

Plan mode is FreeCoder's safety rail for serious work. Instead of editing immediately, the agent first writes a plan — the files it intends to touch, the approach, and the order — and then waits for you. Nothing is modified until you approve.

Why use it

• Catch wrong approaches early, before they turn into a messy diff you have to unpick.
• Steer the design. Comment on a step or rewrite it in your own words.
• Stay in control of large, multi-file changes that touch shared code.

How it works

1. Ask for something substantial — “refactor auth into its own module”.
2. FreeCoder reads the code and proposes a numbered plan.
3. You approve, comment on a step, or rewrite it.
4. On approval, the agent executes — often fanning the steps out to parallel subagents.

PLAN — refactor auth
  1. extract token logic → lib/auth
  2. update 6 call sites
  3. spawn 2 subagents (api · tests)
  → approve · comment · rewrite

When to reach for it

Use plan mode whenever a task spans multiple files, changes shared code, or you're not yet sure how you want it done. For one-line fixes, skip it and let the agent go. Pair plan mode with vibe coding for the best of both worlds: high-level direction, carefully reviewed execution.