Skip to content
    ↑↓ select↵ openesc close
    English中文
    arnavpisces

    Sidebar

    v0.3.6Tools & Commands
    opencode-sidebar

    tmux sidebar launcher for OpenCode

    Actively maintained
    #opencode#opencode-plugin#sidebar#tui#cli#tmux
    GitHub reponpm pageHomepage
    GitHub stars

    19

    Monthly installs

    87

    16 in 7 days

    Composite scoreSCORE

    39.1

    Multi-signal model

    Last commit

    2 months ago

    2026-06-12

    Install and configure

    opencode.json

    Writes to this project's opencode.json — applies to this repository only.

    opencode.json

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

    opencode loads npm dependencies through its embedded runtime on startup and caches them locally — no manual global install needed.

    README.md
    View original→

    npm version

    Tmux sidebar launcher for opencode.

    Why Does This Exist?

    OpenCode is easier to use when the session list, preview pane, and TUI stay together. This launcher keeps them in one tmux session so you can move between the sidebar and OpenCode without losing context.

    Features

    • Left pane for projects and sessions
    • Right pane for the stock OpenCode TUI
    • Enter-based session recall into preview
    • Background active sessions
    • Session deletion from the sidebar
    • Sound notifications when OpenCode needs input or finishes work
    • Automatic cleanup of parked opencode attach panes

    Quick Start

    Prerequisites

    • Node.js 20+
    • tmux
    • opencode

    Make sure they are installed and available in your PATH.

    Package

    Install from npm

    npm install -g opencode-sidebar
opencode-sidebar

    The CLI checks for tmux and opencode at runtime. If either command is missing, it prints a clear error instead of failing silently.

    Build & run from source

    git clone https://github.com/arnavpisces/opencode-sidebar.git
cd opencode-sidebar
bun install
npm run start

    npm run start builds the local dist/ output and launches the same tmux-backed CLI used by the published package.

    Usage

    OpenCode Sidebar Gif

    opencode-sidebar

    Shortcuts

    • ↑ / ↓: move
    • Enter: load or recall the selected session into preview
    • n: new session
    • e: rename session
    • d: delete session with confirmation
    • k: kill a running session window without deleting history
    • /: search
    • a: add a project folder
    • Space: expand or collapse a project
    • Ctrl-b then arrow keys: switch between the sidebar and the OpenCode pane
    • q: quit

    Status Symbols

    • ▶ means currently previewed
    • ◆ means active in background
    • [*] means a session recently completed work and still has unread completion state

    Configuration

    • OPENCODE_SIDEBAR_DIR: override the local state and log directory
    • OPENCODE_SIDEBAR_NOTIFY=0: disable sounds
    • OPENCODE_SIDEBAR_NOTIFY_ATTENTION_SOUND: custom sound for questions and approval requests
    • OPENCODE_SIDEBAR_NOTIFY_COMPLETE_SOUND: custom sound for completion
    • Sound values can be a system sound name like Glass or Ping, or a full path such as ~/Music/done.aiff

    Release Checks

    • npm run verify: typecheck, unit tests, and build
    • npm run verify:tmux: manual tmux integration checks in isolated temp workspaces
    • npm run verify:release: full maintainer-only release check

    Contribution

    Pull requests and opening issues are welcome. For details, see:

    License

    Apache-2.0 © 2026 Arnav Kumar

    If this repo helped you, consider giving it a ⭐. Happy Vibing :)