diff options
| author | OpeOginni <[email protected]> | 2026-03-17 16:07:35 +0100 |
|---|---|---|
| committer | GitHub <[email protected]> | 2026-03-17 10:07:35 -0500 |
| commit | 6708c3f6cf2a61d47d7c4b81d1bf6184c70b9b98 (patch) | |
| tree | 68ed2e115bb7d5e8fbb0b61615c7b3f0581e9faf /packages/web/src/content/docs | |
| parent | ba2297656877f26c50d28977b0e7164868d6868c (diff) | |
| download | opencode-6708c3f6cf2a61d47d7c4b81d1bf6184c70b9b98.tar.gz opencode-6708c3f6cf2a61d47d7c4b81d1bf6184c70b9b98.zip | |
docs: mark tools config as deprecated (#17951)
Diffstat (limited to 'packages/web/src/content/docs')
| -rw-r--r-- | packages/web/src/content/docs/agents.mdx | 8 |
1 files changed, 5 insertions, 3 deletions
diff --git a/packages/web/src/content/docs/agents.mdx b/packages/web/src/content/docs/agents.mdx index 876464212..5522f77aa 100644 --- a/packages/web/src/content/docs/agents.mdx +++ b/packages/web/src/content/docs/agents.mdx @@ -366,9 +366,11 @@ The model ID in your OpenCode config uses the format `provider/model-id`. For ex --- -### Tools +### Tools (deprecated) -Control which tools are available in this agent with the `tools` config. You can enable or disable specific tools by setting them to `true` or `false`. +`tools` is **deprecated**. Prefer the agent's [`permission`](#permissions) field for new configs, updates and more fine-grained control. + +Allows you to control which tools are available in this agent. You can enable or disable specific tools by setting them to `true` or `false`. In an agent's `tools` config, `true` is equivalent to `{"*": "allow"}` permission and `false` is equivalent to `{"*": "deny"}` permission. ```json title="opencode.json" {3-6,9-12} { @@ -392,7 +394,7 @@ Control which tools are available in this agent with the `tools` config. You can The agent-specific config overrides the global config. ::: -You can also use wildcards to control multiple tools at once. For example, to disable all tools from an MCP server: +You can also use wildcards in legacy `tools` entries to control multiple tools at once. For example, to disable all tools from an MCP server: ```json title="opencode.json" { |