Skip to content

docs: mark tools config as deprecated #17951

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
rekram1-node merged 6 commits into from
Mar 17, 2026
+5 −3
Merged

docs: mark tools config as deprecated #17951

Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
6eccffa
feat(opencode): Inherit top level permissions when using legacy tools…
OpeOginni Mar 17, 2026
6be2871
chore: removed installation file changes
OpeOginni Mar 17, 2026
6204413
chore: add comment explaining use of typeof string
OpeOginni Mar 17, 2026
4cc37f3
reverted update to config inheritance
OpeOginni Mar 17, 2026
1b00b66
docs(opencode): deprecate `tools` config in favor of `permission` fie…
OpeOginni Mar 17, 2026
666882c
docs(agents): update `tools` section to indicate deprecation and clar…
OpeOginni Mar 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions packages/web/src/content/docs/agents.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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}
{
Expand All @@ -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"
{
Expand Down
Loading