Docs

Agent

Modes

Develop, Plan, Debug, and Design. Pick the mode that fits the job and switch at any time.

A mode tells the agent what kind of work you want and which tools it should reach for. The chip after + in the composer shows the current mode. Click it to pick another, or press Shift + Tab to cycle through them.

Each mode except Develop has its own color on the chip, and the composer placeholder changes to match.

Develop

Write and change code, run it, see it through.

Develop is the default. Use it to build features, fix bugs, refactor, run commands, implement canvas designs in code, and test in the browser. Computer Use and Cloud computer are available in Develop.

Add a settings section to this page that matches @Settings on the canvas. Use the existing form components.

Plan

Generate an implementation plan before editing.

In Plan mode the agent researches the codebase and writes a plan instead of changing your code. It asks you a question only when it can't pick a sensible default, such as a missing key or a choice with different outcomes. The plan opens as a card in chat marked Plan ready.

Plan a billing upgrade flow. List the files to touch, the risks, and the order of changes.

When you are happy with the plan:

  1. Click View Plan to read or edit it.
  2. Click Implement. Velork switches the chat to Develop and the agent starts working through the plan.
  3. The card tracks progress (In progress · 3/7 done). If a run stops early, click Continue.

Plans are saved as markdown in .velork/plans/ in your workspace. A chat has one active plan at a time; the agent updates it rather than starting a new one.

Debug

Pinpoint the root cause of an issue.

Debug mode works from evidence. The agent forms hypotheses, adds temporary logging to your code, and reproduces the problem. For a web app it can open, it does this in the built-in browser. Otherwise it gives you reproduction steps in a panel above the composer: follow them, then click Proceed (Cmd + Enter). When the logs confirm a fix, click Mark Fixed.

A Debug Mode Active banner shows how many instrumentations are in place, with View Logs and Remove All Instrumentations. The agent removes its logging only after the fix is confirmed. Computer Use and Cloud computer are available in Debug.

The preview crashes after a route change. Find out why and fix it.

Design

Create and refine UI on the canvas.

Design mode works on the design canvas instead of your source files: layouts, typography, components, tokens, and motion. Iterate on the canvas, then switch to Develop to turn the design into code.

Design a pricing page with three tiers and a monthly/yearly toggle.

Capture websites in any mode

There is no separate Inspiration mode. Ask the agent to capture a site in Develop, Design, or Plan, and it pastes the page onto the canvas for you to reference. See Capture websites.

Let the agent switch modes

The agent can ask to switch modes when the work calls for it, for example to Develop when you ask it to implement while in Plan, or to Design when you ask for canvas work. The request appears as a card in the chat with the reason:

  • Switch (Cmd + Enter) changes the mode.
  • Skip (Escape) stays in the current mode.

If you do nothing, the card switches on its own when the bar along its bottom runs out. Hover the card to pause it. The menu on the left of the card sets what happens next time for that mode: Always ask, Always allow, or Always deny.

Clicking Implement on a plan switches to Develop without asking.

Next steps

Chat

The composer, mentions, and toggles

Canvas

Work on designs in Design mode

Capture websites

Capture live sites onto the canvas

Still stuck?

Ask us anything, or see what changed in the latest release.

Changelog