summaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
authorAlan Pogrebinschi <[email protected]>2026-01-18 14:46:04 -0800
committerGitHub <[email protected]>2026-01-18 16:46:04 -0600
commitb4d4a1ea7d2e590e3963b36580989404377e4ce4 (patch)
tree4d4e6506b1e11568f94e0ff72083aec98b717545
parent0d8e706facd193610572f1d5b8ddeba80de0b63a (diff)
downloadopencode-b4d4a1ea7d2e590e3963b36580989404377e4ce4.tar.gz
opencode-b4d4a1ea7d2e590e3963b36580989404377e4ce4.zip
docs: clarify agent tool access and explore vs general distinction (#9300)
-rw-r--r--packages/web/src/content/docs/agents.mdx6
1 files changed, 3 insertions, 3 deletions
diff --git a/packages/web/src/content/docs/agents.mdx b/packages/web/src/content/docs/agents.mdx
index 22bed7f16..ea1f779cd 100644
--- a/packages/web/src/content/docs/agents.mdx
+++ b/packages/web/src/content/docs/agents.mdx
@@ -21,7 +21,7 @@ There are two types of agents in OpenCode; primary agents and subagents.
### Primary agents
-Primary agents are the main assistants you interact with directly. You can cycle through them using the **Tab** key, or your configured `switch_agent` keybind. These agents handle your main conversation and can access all configured tools.
+Primary agents are the main assistants you interact with directly. You can cycle through them using the **Tab** key, or your configured `switch_agent` keybind. These agents handle your main conversation. Tool access is configured via permissions — for example, Build has all tools enabled while Plan is restricted.
:::tip
You can use the **Tab** key to switch between primary agents during a session.
@@ -72,7 +72,7 @@ This agent is useful when you want the LLM to analyze code, suggest changes, or
_Mode_: `subagent`
-A general-purpose agent for researching complex questions, searching for code, and executing multi-step tasks. Use when searching for keywords or files and you're not confident you'll find the right match in the first few tries.
+A general-purpose agent for researching complex questions and executing multi-step tasks. Has full tool access (except todo), so it can make file changes when needed. Use this to run multiple units of work in parallel.
---
@@ -80,7 +80,7 @@ A general-purpose agent for researching complex questions, searching for code, a
_Mode_: `subagent`
-A fast agent specialized for exploring codebases. Use this when you need to quickly find files by patterns, search code for keywords, or answer questions about the codebase.
+A fast, read-only agent for exploring codebases. Cannot modify files. Use this when you need to quickly find files by patterns, search code for keywords, or answer questions about the codebase.
---