wip: desktop work

1 files changed, 31 insertions, 0 deletions

diff --git a/AGENTS.md b/AGENTS.md
index 507cfea53..36a37713b 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -14,3 +14,34 @@
 ## Debugging
 
 - To test opencode in the `packages/opencode` directory you can run `bun dev`
+
+## Tool Calling
+
+- ALWAYS USE PARALLEL TOOLS WHEN APPLICABLE. Here is an example illustrating how to execute 3 parallel file reads in this chat environnement:
+
+json
+{
+    "recipient_name": "multi_tool_use.parallel",
+    "parameters": {
+        "tool_uses": [
+            {
+                "recipient_name": "functions.read",
+                "parameters": {
+                    "filePath": "path/to/file.tsx"
+                }
+            },
+            {
+                "recipient_name": "functions.read",
+                "parameters": {
+                    "filePath": "path/to/file.ts"
+                }
+            },
+            {
+                "recipient_name": "functions.read",
+                "parameters": {
+                    "filePath": "path/to/file.md"
+                }
+            }
+        ]
+    }
+}