Skip to content

Commit 585b5a4

Browse files
authored
docs: describe Console config layer precedence (#58987)
1 parent 2d91ed5 commit 585b5a4

4 files changed

Lines changed: 10 additions & 16 deletions

File tree

‎services/www/src/docs/content/console/harnesses/index.mdx‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -96,4 +96,5 @@ registration, so you sign in from the browser instead of pasting a key.
9696
https://opencode.ai/console/mcp
9797
```
9898

99-
Each harness page shows how to add it.
99+
Each harness page shows how to add it. OpenCode adds the server automatically as `opencode_console` when your workspace
100+
enables it, and asks you to sign in from the browser the first time it uses it.

‎services/www/src/docs/content/console/index.mdx‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,8 @@ member.
3030

3131
## Policies
3232

33-
Providers and Tools rules from the Policies page apply to every OpenCode V2 client
33+
Providers and Tools rules from the Policies page apply to every OpenCode client
3434
connected to the workspace. They are delivered as [policy](/policies#console)
35-
statements with final authority over the member's own configuration and take effect
36-
within about a minute.
35+
statements that outrank the member's user and project configuration and take effect
36+
within about a minute. Managed preferences and the system configuration file still
37+
outrank the workspace; see [precedence](/policies#precedence).

‎services/www/src/docs/content/console/websearch.mdx‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "Web Search"
33
description: "Hosted web search for OpenCode through Console."
44
---
55

6-
Console provides hosted web search to connected OpenCode v2 users. A workspace owner or admin enables it once for the workspace, without giving members a separate search provider key.
6+
Console provides hosted web search to connected OpenCode users. A workspace owner or admin enables it once for the workspace, without giving members a separate search provider key.
77

88
Each successful search costs **$0.01** and counts toward the workspace balance and member spending limits.
99

@@ -19,7 +19,7 @@ Each member then connects OpenCode to the workspace with `/connect`.
1919
/connect
2020
```
2121

22-
OpenCode loads **OpenCode Web Search** from the workspace's managed configuration. Members do not need to set `websearch.provider` or add a provider API key.
22+
The workspace configuration selects **OpenCode Web Search** as the default provider. Members do not need to set `websearch.provider` or add a provider API key. A member who sets their own `websearch.provider` keeps that choice instead.
2323

2424
## Search
2525

‎services/www/src/docs/content/policies.mdx‎

Lines changed: 2 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: "Policies"
3-
description: "Allow or deny OpenCode actions on named resources, with organization policy taking final authority."
3+
description: "Allow or deny OpenCode actions on named resources, with managed and organization policy outranking user and project configuration."
44
---
55

66
Policies decide whether OpenCode may perform an action on a named resource. They are
@@ -190,10 +190,6 @@ configuration and the connected Console always outrank user and project files.
190190
| 5 | Direct `opencode.json(c)`; outer directories beat inner ones |
191191
| 6 (lowest) | `.opencode/opencode.json(c)`; outer directories beat inner ones |
192192

193-
This order applies when the Console serves its workspace configuration in the current
194-
format. A Console that still serves the older format ranks first instead, above managed
195-
preferences and the system file; see [Console](#console).
196-
197193
A repository cannot re-enable a provider you deny globally:
198194

199195
```jsonc title="~/.config/opencode/opencode.jsonc"
@@ -213,16 +209,12 @@ A repository cannot re-enable a provider you deny globally:
213209
## Console
214210

215211
A workspace on the [OpenCode Console](/console) compiles its Providers and Tools
216-
policies into statements and returns them with the workspace configuration. OpenCode
212+
policies into regular `policies` statements in the workspace configuration. OpenCode
217213
merges that configuration like a configuration file that ranks right below managed
218214
preferences and the system file, so an organization `deny` cannot be lifted by a
219215
repository or user `allow`, and an organization `allow` lifts a lower-authority `deny`.
220216
Managed preferences and the system file still override the workspace.
221217

222-
A Console that serves the older format instead has its statements appended after every
223-
authored statement, so they have the final say, over managed preferences and the system
224-
file too.
225-
226218
Denials from these statements name the workspace:
227219

228220
```text

0 commit comments

Comments
 (0)