From d86c10816d75837c8f85e7b1ab0de5ff37ecf77b Mon Sep 17 00:00:00 2001
From: Rafi Khardalian <rafi@actualyze.ai>
Date: Thu, 19 Feb 2026 20:00:06 -0800
Subject: docs: clarify tool name collision precedence (#14313)

Co-authored-by: Aiden Cline <63023139+rekram1-node@users.noreply.github.com>
---
 packages/web/src/content/docs/plugins.mdx | 4 ++++
 1 file changed, 4 insertions(+)

(limited to 'packages/web/src/content/docs/plugins.mdx')

diff --git a/packages/web/src/content/docs/plugins.mdx b/packages/web/src/content/docs/plugins.mdx
index 411b827d2..a8be79821 100644
--- a/packages/web/src/content/docs/plugins.mdx
+++ b/packages/web/src/content/docs/plugins.mdx
@@ -308,6 +308,10 @@ The `tool` helper creates a custom tool that opencode can call. It takes a Zod s
 
 Your custom tools will be available to opencode alongside built-in tools.
 
+:::note
+If a plugin tool uses the same name as a built-in tool, the plugin tool takes precedence.
+:::
+
 ---
 
 ### Logging
-- 
cgit v1.2.3

