The extension will auto-detect or install the OpenCode CLI
Start chatting from the sidebar
No CLI installed? The extension will offer to install it automatically via npm install -g opencode-ai.
Requirements
VS Code 1.96.0 or newer
Node.js (for the auto-install feature)
OpenCode CLI (auto-installed if missing)
Commands
Command
Description
OpenCode: Focus Sidebar
Focus the OpenCode sidebar view
OpenCode: New Session
Create a new OpenCode session
OpenCode: Switch Session
Pick an existing session from a quick pick
OpenCode: Refresh
Reload the sidebar and reconnect
OpenCode: Open Settings
Open the OpenCode Settings tab
OpenCode: Restart Local Server
Restart the managed server
OpenCode: Open Terminal
Open a terminal running the OpenCode CLI
OpenCode: Install CLI
Manually install/update the OpenCode CLI
Keyboard Shortcuts
Shortcut
Command
Cmd/Ctrl+Shift+Alt+.
Focus Sidebar
Cmd/Ctrl+Shift+Alt+O
New Session
Cmd/Ctrl+Shift+Alt+S
Switch Session
Shortcuts are active while an editor or terminal has focus.
Configuration
Settings live under the sidecode.* namespace and are also editable from the in-app Settings tab.
Connection and CLI
Setting
Default
Description
sidecode.opencodePath
opencode
CLI command or executable path (supports ~)
sidecode.serverBaseUrl
http://127.0.0.1:4096
Base URL for the OpenCode server
sidecode.autoStartServer
true
Auto-run opencode serve when needed
sidecode.debugServerLogs
false
Stream server logs to the output channel
Interface
Setting
Default
Description
sidecode.language
auto
App language, or auto for system detection
sidecode.uiColorScheme
system
system, light, or dark
sidecode.themeId
oc-2
OpenCode UI theme id
sidecode.uiFont
""
UI font family override
sidecode.codeFont
""
Code font family override
sidecode.fontSize
14
Font size used by the OpenCode UI
sidecode.autoSave
true
Auto-save edits in OpenCode sessions
sidecode.releaseNotes
true
Show release notes after updates
sidecode.checkUpdatesOnStartup
true
Check for OpenCode updates on startup
Feed
Setting
Default
Description
sidecode.showReasoningSummaries
false
Show reasoning summaries when available
sidecode.shellToolPartsExpanded
false
Expand shell tool results by default
sidecode.editToolPartsExpanded
false
Expand edit/apply_patch tool results by default
Notifications and sounds
Setting
Default
Description
sidecode.notifyAgent
true
Desktop notifications for agent events
sidecode.notifyPermissions
true
Desktop notifications for permission prompts
sidecode.notifyErrors
false
Desktop notifications for errors
sidecode.soundAgentEnabled
true
Sound for agent notifications
sidecode.soundAgent
staplebops-01
Sound id for agent notifications
sidecode.soundPermissionsEnabled
true
Sound for permission notifications
sidecode.soundPermissions
staplebops-02
Sound id for permission notifications
sidecode.soundErrorsEnabled
true
Sound for error notifications
sidecode.soundErrors
nope-03
Sound id for error notifications
Advanced
Setting
Default
Description
sidecode.autoAcceptWorkspacePermissions
false
Auto-accept permission prompts for the current workspace
sidecode.customKeybinds
null
Override OpenCode keybinds by command id
sidecode.modelVisibility
null
Per-model visibility map (providerID/modelID → show or hide)
Upgrading from OpenCode for VSCode? Existing opencodeVisual.* settings are copied to sidecode.* automatically on activation for user, workspace, and folder scopes. Values already set under sidecode.* take precedence.