From 061a08f732949d4887f9c6c8b283632335881ba4 Mon Sep 17 00:00:00 2001
From: spoons-and-mirrors
 <212802214+spoons-and-mirrors@users.noreply.github.com>
Date: Tue, 6 Jan 2026 22:16:16 +0100
Subject: [PATCH] docs

---
 packages/web/src/content/docs/rules.mdx | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/packages/web/src/content/docs/rules.mdx b/packages/web/src/content/docs/rules.mdx
index aa5590bb5f4..2d02ff47f98 100644
--- a/packages/web/src/content/docs/rules.mdx
+++ b/packages/web/src/content/docs/rules.mdx
@@ -92,6 +92,17 @@ Example:
 }
 ```
 
+You can also use remote URLs to load instructions from the web.
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "instructions": ["https://raw.githubusercontent.com/my-org/shared-rules/main/style.md"]
+}
+```
+
+Remote instructions are fetched with a 5 second timeout.
+
 All instruction files are combined with your `AGENTS.md` files.
 
 ---