BrainDocs

Ask vs Agent modes

Choose plain chat (Ask) or tool-enabled coding assistant (Agent).

The composer mode picker switches between:

ModeBehavior
AskPlain conversation — no MCP tools, no sandbox coding tools
AgentTools enabled (connections you turn on) + attached-repo coding when a repo is bound

Cycle modes with Shift+Tab. Preference is persisted as brain.chatMode (default Agent).

When to use Ask

  • Summaries, drafting, Q&A without touching external apps
  • Avoid accidental tool calls or write approvals

When to use Agent

Write tools (create/update issues, messages, etc.) may ask for human approval in the stream before executing.