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.
| Mode | In the menu | What it does | Needs a folder |
|---|---|---|---|
| Agent | Makes the changes itself | Reads, edits files, runs commands and calls connectors, then checks its work. | Yes |
| Plan | Writes a plan first and waits | Reads and researches, then writes a plan file for you to review and build. Changes no code. | No |
| Ask | Answers questions, changes nothing | Answers from your code, using read-only tools and web search. | No |
| Debug | Finds the cause with runtime logs, then fixes it | Reproduces the bug, adds temporary logging, reads what the program did, fixes the cause and removes the logging. | Yes |
Switching modes
- Click the mode control in the composer and pick a mode. While the menu is open, the number keys 1 to 4 pick a row.
- Press Cmd+. (Ctrl+. on Windows and Linux) in the message box to cycle through the modes.
- To run an earlier message again in another mode, hover it and choose Edit: the message goes into the message box, so pick the mode there and send. The strip over the box says which mode it resends in, and that everything after the message is replaced.
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
- Open a folder for the agent to work in: Agent and Debug need a folder. Open one, or use Ask.
- UNAVAILABLE in a read-only mode: Ask or Plan tried to run a command that is not on the read-only list. Switch to Agent if you want it run.
- More on Agent run problems.
← Agent overview Approvals and permissions →
All documentation
Get started
Using the editor
- Tab completion
- Edit and ask about a selection
- Reviewing the agent's changes
- Git: commit messages, branch review and conflicts
- Dictation
- Layout, themes and the settings page
Agent
- Agent overview
- Agent, Plan, Ask and Debug
- Approvals and permissions
- Plan mode
- Debug mode
- Tools
- Browser tools
- How the agent checks its work
- Checkpoints and undo
- Running several agents at once
- Subagents and background tasks
- Remote agents in GitHub Actions
- Infrastructure as code
Context
Workspaces
Connectors
- Connectors (MCP servers)
- Connector configuration reference
- Use AstraCode from Claude, ChatGPT and other apps
Extending AstraCode
CLI
Account and usage
- Usage and limits
- Bring your own key
- What AstraCode sends and keeps
- Reporting a problem and getting help
Troubleshooting
- Troubleshooting
- Sign-in problems
- Install and update problems
- Chat panel problems
- Agent run problems
- Connector problems
- Dictation problems
- Usage, billing and network errors
- CLI problems