OpenCode Projects Sidebar

A projects and sessions sidebar for the OpenCode TUI.

The plugin uses OpenCode's native session sidebar slot, so the standard chat layout remains intact. It groups sessions by project, shows session status, and lets you open a session directly from the sidebar.

Requirements

• OpenCode 1.18.27 or a compatible release with TUI plugin slots
• A terminal with at least 128 columns for automatic first-time opening

The plugin currently renders in the native session sidebar. It is not shown on the home screen because OpenCode does not expose a home-screen sidebar slot.

Installation

Add the npm package to your OpenCode configuration:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-projects-sidebar"]
}

Restart OpenCode after changing the configuration.

To use custom options, use the tuple form:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": [
    [
      "opencode-projects-sidebar",
      {
        "width": 36,
        "limit": 50,
        "keybind": "ctrl+shift+s"
      }
    ]
  ]
}

Usage

• ctrl+s toggles the sidebar. This fallback works in terminals that drop Shift from ctrl+shift+s.
• ctrl+shift+s is the configured default binding.
• Click a project header to collapse or expand its sessions.
• Click a session to open it.
• Use the refresh button to reload sessions.

On first run, the sidebar opens automatically when the terminal is at least 128 columns wide. The choice is persisted in OpenCode's KV storage.

Options

| Option | Default | Description | | --- | ---: | --- | | width | 36 | Sidebar content width, clamped to 20-60 columns | | limit | 50 | Maximum number of sessions to request | | keybind | ctrl+shift+s | Main toggle key binding |

Development

npm install
npm run typecheck

The package intentionally ships the TypeScript/TSX entry point. OpenCode loads TypeScript plugins directly.

License

MIT