marcus/sidecar

Create Adapter covers building conversation adapters that import AI chat history from tools like Claude Code, Cursor, Warp, and Codex. Use it when creating or debugging an adapter’s parsing, caching, watch handling, or performance behavior.

Create Modal builds declarative dialogs with the internal/modal library, including confirm, input, select, form, and custom sections. Use it when adding modals or dialogs that need built-in keyboard, mouse, and overlay handling.

Create Plugin explains how to build Sidecar plugins that implement the plugin interface, render Bubble Tea views, and wire keyboard input, footer hints, event bus, and lifecycle hooks. Use it when adding a plugin or debugging plugin rendering and init/stop behavior.

Create Theme configures Sidecar color themes, including base theme selection, color overrides, gradient borders, tab styles, and syntax themes. Use it when creating or adjusting UI appearance or troubleshooting color and style issues.

Drag Pane implements drag-to-resize behavior for two-pane layouts. Use it when adding or fixing divider dragging, width clamping, mouse hit regions, or saved pane widths.

Feature Flags gates experimental functionality in Sidecar with user-configurable settings. Use it to register flags, check them in code, and manage config or CLI overrides with clear priority rules.

Inline Editor adds in-pane file editing in the file browser preview using a tmux PTY backend. Use it when working on inline editing flows, text input, or editor input and rendering issues.

Keyboard Shortcuts documents Sidecar’s keybinding registry, shortcut contexts, and complete assignment table. Use it when adding or changing shortcuts, checking conflicts, or comparing bindings with vim and other TUI tools.

Merge Strategy covers git pull and merge workflows in sidecar, including merge, rebase, fast-forward, squash, and protected-branch handling. Use it when configuring branch integration behavior or deciding how changes should be merged.

Profile Memory helps investigate Sidecar memory growth, goroutine leaks, open file accumulation, and CPU hotspots with pprof and system tools. Use it when debugging leaks, unresponsive plugins, or performance issues.

Project Switching opens a modal to filter and switch between configured projects without restarting Sidecar. It manages project state, previews themes, and reinitializes plugins after a switch.

Release Sidecar prepares and publishes new Sidecar versions. It covers semver tagging, dependency and changelog updates, release automation, Homebrew tap publishing, and post-release verification.

Shell Integration adds interactive tmux-based shell input, output capture, cursor rendering, and scrollback handling in the TUI. Use it for shell integration, command execution, paste handling, and inline editing.

Sidecar Website helps write and maintain the Sidecar Docusaurus docs site, including docs pages, blog posts, images, styling, and deployment. Use it when editing documentation content or site configuration.

UI Features implements sidecar UI and UX components such as modals, keyboard shortcuts, mouse support, pills/tabs, scrolling, and pane resizing. Use it when adding or updating interactive UI behavior and input handling.

Worktree Switching supports changing Sidecar’s active git worktree, reinitializing plugins, and restoring per-worktree state. Use it when implementing worktree-aware behavior or handling deleted worktrees and fallback to main.