opencode icon indicating copy to clipboard operation
opencode copied to clipboard

Permission revamp docs + new API endpoints

Open opencode-agent[bot] opened this issue 2 weeks ago • 0 comments

Findings (new user-facing changes)

  • 351ddeed9 “Permission rework (#6319)” introduces a revamped permission system that now gates many more tools (ex: read, list, glob, grep, task, codesearch, websearch, todowrite, todoread) and changes how “always” rules work for bash (command-prefix/arity based).
  • It also adds new server/API surface area for permissions: GET /permission and POST /permission/:requestID/reply, while keeping the old session-scoped permission endpoint as deprecated.

Other listed commits looked like tests/bugfixes/internal changes or already-updated docs (5f2be55e5).

Docs Updated

  • Updated permission docs to cover the expanded permission keys + updated bash “always” semantics: packages/web/src/content/docs/permissions.mdx:6
  • Updated server API docs to document the new permission endpoints and mark the old one deprecated: packages/web/src/content/docs/server.mdx:159
  • Updated JS SDK docs to add client.permission.* methods and remove the old session-scoped permission method from Sessions: packages/web/src/content/docs/sdk.mdx:252
  • Updated plugin event list from permission.updatedpermission.asked: packages/web/src/content/docs/plugins.mdx:171
  • Updated agent permissions docs to reflect that permissions apply to more than edit/bash/webfetch: packages/web/src/content/docs/agents.mdx:385

Validation

  • packages/web docs site builds successfully via bun run build (warnings only, no failures).

Triggered by scheduled workflow

New%20session%20-%202026-01-02T00%3A26%3A10.665Z opencode session  |  github run

opencode-agent[bot] avatar Jan 02 '26 00:01 opencode-agent[bot]