Docs › Agent › Agent, Plan, Ask and Debug

Agent, Plan, Ask and Debug

The four modes a message can be sent in, what each one may do, and how to switch between them.

On this page

Every message is sent in one of four modes. The mode decides what the agent may do with that message, not how much it asks you first; that is a separate setting, described in Approvals and permissions.

ModeIn the menuWhat it doesNeeds a folder
AgentMakes the changes itselfReads, edits files, runs commands and calls connectors, then checks its work.Yes
PlanWrites a plan first and waitsReads and researches, then writes a plan file for you to review and build. Changes no code.No
AskAnswers questions, changes nothingAnswers from your code, using read-only tools and web search.No
DebugFinds the cause with runtime logs, then fixes itReproduces the bug, adds temporary logging, reads what the program did, fixes the cause and removes the logging.Yes

Switching modes

The box's placeholder text changes with the mode, so you can tell at a glance which one a message will go in. While a plan is being built, the mode control reads Building.

Agent

The default mode for getting work done. It has every tool: see What the agent can do. It needs a folder: with none open, the chat shows Open a folder for the agent to work in, puts your message back in the box, and offers Open Folder and New folder.

Two composer features work only in Agent mode: the button beside Send that runs the prompt as several agents at once (Running several agents at once), and the /goal and /loop commands, which always start Agent runs.

Plan

Plan mode researches, may ask you a few clarifying questions, and writes a plan as a Markdown file with a checklist of steps. Nothing in your code changes until you press Build. See Plan mode.

Ask

Ask answers questions about your code and changes nothing. It can read files, list and search them, use the language server, search by meaning, run a short allowlist of read-only commands (see Running commands), and search the web. It cannot fetch a page, use connectors or start agents. It works with no folder open.

An Ask turn reads for at most 12 rounds, then writes its answer from what it has. Your project rules apply to Ask too; turn that off with Apply project rules in Ask mode under AstraCode Settings, Agents, or astracode.ask.projectRules, if you want short, plain answers.

Debug

Debug is an Agent run with a stricter workflow for bugs that only show up when the program runs: measure first, then fix. See Debug mode.

If something goes wrong

← Agent overview Approvals and permissions →

All documentation

Get started

Using the editor

Agent

Context

Workspaces

Connectors

Extending AstraCode

CLI

Account and usage

Troubleshooting

Reference