Skip to content

Latest commit

 

History

History

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 

README.md

opencode — OpenCode

Account boundary: inseparable — stored provider authentication and runtime data have no proven disjoint profile boundary, so multi-cli refuses the account-overlay contract on every platform.

OpenCode resolves config from OPENCODE_CONFIG_DIR and OPENCODE_CONFIG. That relocates configuration, but stored logins and sessions cannot yet be split truthfully; only configuration paths are classified as shareable.

Install

npm i -g opencode-ai

Binary discovery: %APPDATA%\npm\opencode.cmd (Windows), /usr/local/bin/opencode (macOS), $HOME/.npm-global/bin/opencode (Linux), then opencode on PATH.

Quickstart

Stored-login profiles use whole-root isolation:

multi-cli new opencode/work --isolated
multi-cli launch opencode/work

Account boundary

  • Mechanism: inseparable — per adapter.json, "Stored provider authentication and runtime data do not have a proven disjoint profile boundary."
  • Declared launch env: OPENCODE_CONFIG_DIR={runtimeRoot}, OPENCODE_CONFIG={runtimeRoot}/opencode.json.
  • Logout scope: user — a logout affects the whole OS-user credential state.

Shared normal state

Configuration only (a candidate classification, not an isolation claim): opencode.json, tui.json, agents/, commands/, modes/, plugins/, skills/, tools/, themes/.

No session paths are declared shareable, and no profile-local credentials can be carved out today.

Known limitations

  • Stored-login mode cannot run two accounts with a truthful boundary; multi-cli continue is unavailable because sessions and credentials are not separable.
  • Direct provider environment credentials may become a processSecret candidate later; they are not part of this adapter today.

Support

Windows macOS Linux
supported (--isolated) supported (--isolated) supported (--isolated)