Skip to main content

Permissions and Runtimes

Permissions

Permissions panel

Default permission mode offers Ask for approval, Auto-approve edits, and Full access, with the same meaning as in Composer. Saved grants appear below under Registry writes, Local compute, Connectors, File operations, Skills, and Built-in tools.

  • Filter permissions by scope: All, Global, Project, or Session.
  • Grant row: shows the capability, qualifier, and scope label. A session scope can link to Open Session: ….
  • Connector policy hint: opens the related Connector.
  • Revoke <capability>: revoke the grant after confirmation. A notice appears if a broader global or project grant still covers it.
  • Refresh or load error: when a store is incomplete, a warning prevents you from mistaking the visible list for the full grant set.

Revocation applies only to later requests; it does not reverse finished operations. Full access also removes prompts for commands and network calls. It is not a suitable long-term default outside an isolated environment.

Runtimes

Runtimes panel

Notebook runtimes is divided into Python and R. Each language can use an app-managed environment or a user interpreter:

ControlBehavior
Enable <environment>Let the agent select this environment
Add interpreterBrowse for or enter an existing Python or R executable
Download and set upInstall an app-managed environment and show its progress
Allow package installLet Open Science install packages into this user environment, which explicitly changes it
PackagesOpen the package list and manager
Filter packages…Filter installed packages by name
Add/Install packageEnter a package name and optional version, install it, then restart the kernel when prompted
Remove/UninstallRemove a package or inactive runtime after confirmation
Repair/RetryDetect or repair a failed app-managed environment again

Package installation for a user interpreter writes to your own environment, not app-managed storage. Do not bypass the interface by running %pip, !pip, install.packages(), or a system installer in a Notebook cell; doing so breaks tracked environment selection. An R runtime can initialize only when needed, so its first run may take longer.

Restore defaults re-adds only missing safe baseline grants and leaves other grants unchanged. A denial applies to the current turn: the agent is told not to retry or approximate the refused operation.

In v0.26.0, the safe baseline also covers routine read-only notebook runtime/state inspection, Memory queries, package inventories, and progress updates for an already approved plan. These defaults reduce repetitive prompts but do not authorize writes, package changes, network access, or a new plan. Inspect the exact capability and scope in Settings and revoke it when it no longer fits the project.

For an app-managed runtime, Reinstall drains running kernels and durably rebinds sessions before replacing managed files. External interpreters are never changed by this action. Allow agent-created environments controls autonomous creation; explicit setup and repair remain available when it is off. Network protection status links to the runtime-domain settings and must not be read as protected until the panel reports it active.