You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 8227111
Browse filesBrowse the repository at this point in the historyBrowse files
### Issue for this PR
Closesanomalyco#51341Closesanomalyco#51262
### Type of change
- [x] Bug fix
- [ ] New feature
- [ ] Refactor / code improvement
- [x] Documentation
### What does this PR do?
V2 retained the `instructions` config field but never ported its resolver from the legacy runtime. This restores configured local files, relative globs, `~/` and absolute paths, and HTTP(S) URLs. Sources join discovered `AGENTS.md` instructions and refresh when their file or config changes.
### How did you verify your code works?
- `bun test test/instruction-discovery.test.ts` and `bun typecheck` in `packages/core`
- `bun run check` at the repository root
- `bun run check:generated` and `bun run build` in `services/www`
### Screenshots / recordings
Not applicable; there is no UI change.
### Checklist
- [x] I have tested my changes locally
- [x] I have not included unrelated changes in this PR
Co-Authored-By: OpenCode (GPT-5.6-Sol) <[email protected]>
Copy file name to clipboardExpand all lines: services/www/src/docs/content/instructions.mdx
+3-5Lines changed: 3 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -38,9 +38,7 @@ Keep guidance that applies everywhere in the global file. Put repository-wide gu
38
38
39
39
If the workspace is outside the project root, only the global file is loaded. Set `OPENCODE_DISABLE_PROJECT_CONFIG=1` to skip project `AGENTS.md` discovery without disabling the global file.
40
40
41
-
<Callouttype="note">
42
-
OpenCode V2 recognizes `AGENTS.md` only. It does not use `CLAUDE.md` as a fallback.
43
-
</Callout>
41
+
<Callouttype="note">OpenCode V2 recognizes `AGENTS.md` only. It does not use `CLAUDE.md` as a fallback.</Callout>
44
42
45
43
## Discovery
46
44
@@ -100,7 +98,7 @@ Instruction values remain privileged. Clients can see which sources changed, but
100
98
101
99
## Configuration
102
100
103
-
The V2 config schema accepts an `instructions` array, but V2 does not currently resolve its files, glob patterns, or URLs. This configuration does not add instructions to the model yet:
101
+
Use the `instructions` array to add files, glob patterns, or HTTP(S) URLs alongside discovered `AGENTS.md` files:
104
102
105
103
```jsonc title="opencode.jsonc"
106
104
{
@@ -109,4 +107,4 @@ The V2 config schema accepts an `instructions` array, but V2 does not currently
109
107
}
110
108
```
111
109
112
-
Use `AGENTS.md` for active V2 instructions. See [Config](/config) for configuration locations and precedence.
110
+
Relative patterns are resolved upward from the current workspace to the project root. Absolute paths and `~/` paths resolve directly, and remote instructions use a five-second request timeout. See [Config](/config) for configuration locations and precedence.
0 commit comments