Changelog

• d6c86c1 fix(update): show why an update failed, not just that it did

Changelog

• 147454f feat(cli,ui): auto-apply shell rename live and update agent instruction copy
• 0ee8c80 perf: stop an idle Sidecar from burning ~25% CPU on git subprocesses
• ecf590f release: dispatch and wait for Go CI instead of failing on a pending run
• a531148 version: keep only the cgo warning suppression we actually need
• 3615984 version: make the automated go install match the working manual one

Sidecar 1.0. The surfaces that were converging over the 0.9x series — the project workspace and the global Sessions browser, the pane frame under both, the CLI agents reach Sidecar through — are now one model with one set of rules, and the configuration you needed a text editor for lives in the app.

Features

• Configuration, in the app. A full Configuration surface with its own chrome, navigation, and search: Sidecar Setup, Diagnostics, Appearance, Projects, Workspaces, Agents, Terminal, Panels & Integrations, Advanced, and About. Readiness checks sit behind Setup and Diagnostics, each with a focused repair. Controls are real dropdowns rather than values that cycle, the theme picker previews live, and startup recovery routes a broken install to the page that fixes it.
• Themes unified. Sidecar Modern is the default, alongside 20 curated palettes. The theme system is one registry the app, the picker, and the website all read.
• Global Workspaces reaches parity with the project view. Create project shells and worktrees from the global browser, delete and merge from it, reveal from it, and get the same launch lifecycle, shell-liveness handling, and refusal rules. Both sidebars share one header ([sort] [+]), one age formatter, and a sort — by activity, recency, or name — that is remembered per project and reachable from the keyboard with v.
• One pane frame under both surfaces. internal/panelayout and internal/paneframe own pane structure, geometry, chrome, borders, the compositor, and hit regions; each surface binds to them in a single file. Drag handles work on every resizable split, live panes debounce their resize until the divider drops, and a unified focus ring follows the pointer and takes the keyboard.
• Panes hold content, not modes. Diff, Task, issue, and file leaves open beside the live terminal instead of replacing it, each with its own tab strip: click a tab, { / } to cycle, x to close. Project tabs persist per terminal surface; global tabs stay in memory for the selected row.
• sidecar open works from anywhere. Outside a Sidecar shell, against the workspace root, for multiple requests in one run, and into a Diff leaf (--diff, or by clicking an underlined git hash or range). It reports when an open was retargeted into an existing pane. sidecar --agents documents the whole surface for agents.
• Live panes refresh themselves. internal/livewatch keeps issue, document, and diff panes current without a keypress.
• The file finder and project search moved into shared packages and are now available inside workspace file panes, sized to the widths a real pane gives them.
• Diff viewing grew up: an extracted workspacediff viewer with its own keys and paging, commit-as-root tabs, section line totals, and a total commit count in Git.
• Conversations gained a Grok adapter for sessions and resume.
• Notes runs on td's public pkg/notes API rather than its own database handling.
• A new homepage. The marketing site is rebuilt around the app it is selling, with Sidecar's real chrome re-created as browser components and all 21 themes live from the same data the binary uses.

Changed

• Create New Worktree is a stable form: type a natural name, press Enter. Base branch, task, and agent are one-line Combo fields that overlay instead of stretching the modal. Git uses a slug of the display name, kept separate from the display name you typed.
• The header's hierarchy was redesigned, and cycling now works across the whole header.
• Inertial wheel scrolling has exact boundary answers on every surface and every modal kind, instead of forwarding past the edge.

Bug Fixes

• Worktree tmux sessions key on path identity, so renaming a worktree no longer strands its session.
• Workspace terminal ownership is synchronized, closing a race that let a stale pane paint over a live one.
• Shell liveness is hardened against resurrection and wedged tmux.
• Clicked git specs resolve so a click and the CLI land on the same tab.
• Stale full-file paint is cleared on scope and file change; Diff tabs repaint through the host adapter.
• Files keeps its preview modes when closing tabs for a path, and closes the right ones.
• Worktree removal has one path, with force as an explicit caller intent, and probe deadlines are deterministic.

Removed

• Prompt templates and the prompt picker. Task-linked agent launch still injects task context automatically.
• The worktree Output / Diff / Task tab row. Diff and Task are header action chips that insert a leaf; d, the chip, and sidecar open --diff are the paths into Diff.
• Link Task from the Create Worktree modal.

Dependencies

• github.com/marcus/td v0.58.0 (public pkg/notes API)
• github.com/marcus/tasks v1.8.3

Features

• Worktree terminals are terminals. The Output / Diff / Task tab row is gone. Diff and Task stay as header action chips that insert a leaf beside the live terminal. , / . no longer cycle worktree views; they cycle Diff target tabs only while a Diff leaf is focused. d, the Diff chip, and sidecar open --diff are the paths into Diff.
• --disable-feature=workspace_doc_panes now means no Diff: there is no pane tree, so d / the Diff chip / sidecar open --diff toast or no-op ("Document panes are disabled; Diff needs the workspace pane tree").
• File preview tabs are now clickable in both project and global Workspaces, with global previews retaining multiple open files instead of replacing the current one.
• Issue panes in project and global Workspaces keep one tab per open td id instead of replacing the current issue. Click a drawn tab to select it; { / } cycle; x closes the active tab. Project tabs persist per terminal surface (q hides, last x forgets). Global tabs stay in memory for the selected row and are not written to disk.

Bug Fixes

• Project workspace tab clicks now select the intended file without being stolen by the terminal preview or pane divider.
• Global and project Workspaces once again share pane placement and resizing behavior, including stacked file and issue panes, draggable nested dividers, and per-workspace restoration of pane layouts and scroll positions.

Features

• Workspace previews are now a real pane system. A terminal can sit beside nested document and td-issue panes, each placed and composed from one shared rectangle model. Clicking a file or issue opens it in that tree, repeated documents collect into tabs, focused panes can be closed or zoomed, and the full in-workspace layout survives restart (external files remain session-only). Small windows degrade to one focused pane without corrupting the saved tree.
• Issues are useful inside the workspace, not only in a modal. Issue panes share the existing fetch and rendering core, show the full issue card, scroll under mouse or keyboard control, and retarget in place when another td id is clicked.
• Editing stays in Sidecar while each surface keeps the right editor. Notes regain their lightweight editor, workspace documents can edit notes in their pane, and the file browser keeps its tmux-backed inline editor. Full tmux attach and the experimental terminal split are now explicit opt-ins instead of escape hatches that unexpectedly replace the Sidecar experience.

Bug Fixes

• Terminal scrolling now follows one rule everywhere. Watched and live panes share scrollback keys, wheel routing, history access, gesture pinning, flick cadence, and shifted-key handling across project and global workspace surfaces. The reader's viewport is preserved when interaction ends.
• Pane geometry now reaches the tmux window even when a control-mode transport owns it, so opening a document or dragging a divider resizes and redraws the terminal immediately instead of waiting for a later click.
• Notes editing no longer leaks its command into other palettes, file-browser inline editing keeps its own input ownership, and preview/tab cleanup removes stale panes without leaving the selection on missing content.

Dependencies

• Tasks embedding updated to v1.8.2, adding bounded store-lock waits and verifiable public-install provenance.

Features

• A global scope that spans every project. Sidecar now has a second space above the per-project one, with its own tabs — Overview, Workspaces, and a hosted Tasks — reached without switching projects first. One shared workspace catalog feeds it, so every project's worktrees and shells appear in a single list that filters, sorts, and groups. Sorts carry section headers (Project / Recent), rows show kind, project, name, and age on one line, idle worktrees hide by default behind a sort/filter fly-out, chosen rows pin to the top, and the last global tab survives a restart. The header breadcrumb names the global Overview so the current space is never ambiguous.
• Global workspaces are live, not just listed. Selecting one previews its terminal read-only; entering hands it the keyboard, so an agent running in another project can be watched and driven from one place. Each row carries Output, Diff, and Task tabs, shells can be renamed in place, and Diff jumps to the target project's Git plugin with that project's checkout selected.
• Document panes ship enabled. Markdown mentioned by an agent opens beside the terminal in a real pane tree, with panes that persist and resize across restarts, m (and a clickable chip) toggling rendered against raw, and any local file an agent prints — not only markdown, not only paths inside the worktree — openable straight from the terminal by clicking its link.
• Child shells nest under their parent worktree in the project sidebar, so a worktree and the shells opened inside it read as one group.

Bug Fixes

• Terminal windowing is now one rule instead of several. Placement, freezing, wheel notches, and selection geometry moved onto a single shared bottom-relative window model in internal/tty, fixing a family of drift bugs: panels that resized to the wrong height, a pin left frozen by an empty gesture, a notch that thawed a window mid-selection, clipped primary previews, and term-panel or editor chrome being mistaken for a worktree pane.
• Backslash hides the sidebar without dropping into the watched preview, q types normally in the global Rename Shell modal, Enter closes the View fly-out after applying a sort, and the Task tab's m no longer fires while a hidden doc pane holds focus.
• Workspace diffs load the first commit without moving the cursor, compare short against full hashes correctly when skipping commits, and no longer gate the global preview on capture freshness.

Dependencies

• td updated to v0.57.0: reopening an issue now supersedes the stale approval, the review buckets that were classified but never drawn are painted, and the monitor's kanban stops crushing card width with empty columns.
• Tasks embedding updated to v1.8.0, bringing the redesigned Projects view, urgency bands, and the shared row vocabulary.

Features

• Conversations is opt-in via the conversations_plugin feature flag (default off). The multi-agent session history tab no longer ships enabled. When the flag is off (the default), Sidecar does not register the plugin, does not construct history adapters, and does not read agent session stores — so there is no Detect/watch/load cost for users who do not need the tab. Re-enable with "features": { "flags": { "conversations_plugin": true } } in ~/.config/sidecar/config.json, or sidecar --enable-feature=conversations_plugin. With the flag on, plugins.conversations.enabled: false remains a hard off-switch. Tab shortcut numbers for plugins after Conversations shift left when it is off.
• The embedded Tasks tab is framed like every other plugin. Sidecar draws the shared gradient panel around Tasks and renders the embedded model at the panel's interior size, shifting mouse coordinates past the frame so clicks, drags, and wheel events land where Tasks expects them. Unavailable and loading states stay unframed.
• sidecar shell name reports the current shell's name from the manifest, so an agent can check whether a stale name still describes its work. Naming guidance now asks agents to rename whenever a previous task's name no longer fits, and Grok launches receive the same rules.
• Codex status detection is more accurate.

Performance

• Git diff rendering cost no longer scales with file size. Line truncation scanned a line rune-by-rune from the end and re-measured the whole candidate at each step, so a single 10KB minified JSON line took 577ms to truncate and a 100KB line took about a minute — repeated for every visible line, every frame. Truncation now scans forward against a width budget (577ms → 1.4µs for a 10KB line; 2.5µs at 100KB, output unchanged across widths, CJK, emoji, and combining marks), truncation happens before syntax highlighting so chroma no longer tokenizes discarded bytes, max line number and side-by-side content width are memoized on the parsed diff, and side-by-side pair grouping is cached per hunk with above-viewport hunks skipped.

Dependencies

• Tasks embedding updated to v1.7.0, adding ordered labelled task links and the multi-link picker.

Features

• The embedded Tasks tab adopts Tasks v1.6.0's refreshed visual system. Every list now shares aligned priority and metadata columns, section rules and counts; Agenda uses calendar groups; and the detail rail adds clearer state, labels, actions, links, and subtask progress.

• Agents can rename their current shell through a deterministic CLI. sidecar shell rename [--json] <name> updates the Sidecar-owned display name without renaming the tmux session or terminal title. New shells publish their name through SIDECAR_SHELL / SIDECAR_SHELL_NAME, and supported harnesses are prompted to replace generated names with meaningful ones.

• Overview completion means recently finished work. Sidecar persists semantic activity transitions so newly completed agents stay visible as done without classifying every old idle shell as a fresh completion.

• The Git sidebar shows section line totals and the repository's total commit count. Async loads are request-ID guarded so stale history results cannot overwrite a newer repository view.

• Brackets cycle top-level tabs consistently. [ and ] now move through the assembled plugin order, with contextual plugin commands retaining precedence where they own those keys.

• The update journey now covers every product Sidecar knows about, and tells the truth about each one. Pressing u from diagnostics shows one confirmation naming every product that will change, with its current and target version and the install method Sidecar will use — Sidecar 0.95.0 → 0.96.0 · Homebrew. When the tasks_plugin feature is effectively enabled (config or CLI override, exactly as plugin assembly resolves it) and the standalone tasks command is installed, the Tasks suite joins Sidecar and td in that list. With the feature disabled, no Tasks check, process, or network request happens at all.

  Sidecar never installs Tasks just because the plugin is enabled: if the standalone commands are missing, diagnostics show embedded only · standalone not installed with the supported brew install marcus/tap/tasks command, and updating Sidecar refreshes only its embedded Tasks tab. A confirmation updates; it does not install a new product.

Fixes

• Terminal selections preserve application-painted background colours. The overlay now composites selection styling without leaving harness-rendered backgrounds in the wrong state.
• Each product now uses its own install provenance. Sidecar previously reused its own detected install method to update td, which could run the wrong command on a mixed installation. Provenance is now resolved per product by checking whether the executable you actually run belongs to the formula (brew --cellar) or to your active Go bin directory — so a Homebrew Sidecar alongside a go installed td, or an active local Tasks development selector, is handled correctly. An unrecognised install is reported with a manual command rather than overwritten.
• A failure no longer erases earlier successes. Targets run sequentially and each one's outcome is retained, so completion distinguishes updated, already current, needs a manual update, and failed, with a per-target manual command for anything that failed. Retry runs only the failed products.
• Restart is only claimed when Sidecar itself changed. A td- or Tasks-only update no longer asks you to quit Sidecar.
• Verification compares exact versions, asking each binary in its own dialect. Every binary a release ships must report the released version afterward — for Tasks that means tasks, tasks-tui, and tasks-api together, so a partially updated suite is a failure rather than a silent success. Success is never inferred from exit status or Homebrew wording alone.
• The progress modal no longer offers a cancel it cannot honour. It now shows which product is being changed and what already settled, and says Update in progress; the running package manager was never cancellable.

Dependencies

• Updated the embedded Tasks TUI from v1.5.0 to v1.6.0.

Features

• Tasks tab (Beta), off by default. Sidecar can now embed the Tasks TUI as a tab, sharing one application rather than reimplementing a second task tool. Tasks keeps ownership of its storage, rendering, overlays, and agent queue; Sidecar owns placement, lifecycle, keys, help, and the footer. Sidecar never reads or writes tasks.jsonl directly. Requires a configured Tasks install — an unconfigured or unreadable store shows a diagnostic and a setup hint rather than an empty list that looks authoritative.

  Enable it by adding the feature flag to ~/.config/sidecar/config.json:

  {
    "features": { "flags": { "tasks_plugin": true } }
  }
  

  The tab appears after Workspaces by default. To place it after Notes instead:

  {
    "plugins": { "tasks": { "position": "after-notes" } }
  }
  

  Beta: the tab is usable day to day, but per-project context following, work search across td and Tasks, and workspace/capture links are still to come.

• Contextual plugin keys take precedence over global keys. Key input now resolves through a documented ladder — Sidecar modal, plugin text-input or blocking overlay, plugin contextual binding, Sidecar global, then unbound forwarding — so a plugin showing its own list decides what a key means while it is focused. Driven by two opt-in interfaces, KeyRouter and FooterStatusProvider; plugins that do not implement them behave exactly as before. ctrl+c, q, and ? are host-reserved and can never be captured by a plugin. Recorded in docs/adr/0001-contextual-plugin-keys-take-precedence.md.

• Tab order is data, not statement order. Plugin registration moved out of main.go into internal/plugins/assembly, whose Plan is a pure function of config plus feature flags. Tab shortcut numbers are derived from the resulting order; nothing assumes a fixed number when preceding plugins are disabled.

• The command palette carries commands that have no key. A plugin can publish an invocable command without binding a key, and it still appears in ? and the merged help. This is what lets Sidecar decline a key without making the underlying command unreachable.

Bug Fixes

• The footer no longer advertises keys that do something else. Only bindings Sidecar will actually honour are registered, so a plugin key the host reserves or refuses cannot appear in the footer or merged help labelled as if it worked.
• Registering a plugin binding twice is a no-op. Binding tables grew on every project switch, since plugins re-register on model adoption while the keymap lives for the process.
• A transient toast is no longer hidden by a persistent plugin status. A plugin reporting a long-lived condition previously masked every toast for that tab, including update-and-restart notices.

Dependencies

• Adds github.com/marcus/tasks v1.5.0, the embeddable Tasks TUI.
• Raises the go directive to 1.26.0 to match that module.
• github.com/marcus/td stays at v0.56.0 (already latest).

Features

• Copy terminal selections with cmd+c. On terminals that deliver the macOS shortcut to Sidecar, cmd+c now copies selected text in both read and interactive modes; alt+c remains the portable and configurable alternative. Copying with no selection leaves the clipboard untouched and points to select-all. Super, Meta, and Hyper chords that tmux cannot faithfully encode are swallowed instead of typing stray characters into the pane.

Bug Fixes

• Terminal selection behaves like a native terminal. A drag that begins on a passive terminal now selects immediately without activating, reframing, or jumping to the top of scrollback; a motionless click still activates on release. Double-click-and-drag extends by words, triple-click-and-drag extends by lines, shift-click extends to padding and chrome, and dragging beyond an edge continues through scrollback with bounded auto-scroll. Selection remains local even when the program inside the pane enables mouse tracking, while motionless clicks still reach that program.
• Selection highlighting remains visible over application-painted backgrounds. Multi-line selections no longer disappear on rows whose own ANSI styling sets or resets the background, including pinned-panel layouts, and the original row background is restored after the selected span.

Bug Fixes

• The Agent Overview owns the keyboard while it is open. Opening the board over a workspace left in interactive mode no longer routes your keys into the hidden tmux pane: esc, q, and K close the board (q closes it rather than quitting sidecar), global shortcuts (@, #, W, ?, !, `, ~, 1-9) keep working over an embedded shell, and unhandled keys — including bracketed paste and unparsed CSI u sequences, which previously typed straight into the covered pane and could run on newline — stop at the Overview instead of reaching a plugin you cannot see. The overview context bindings are registered so ? lists them, and the footer shows the board's own hints.
• Option/Alt keys reach the pane as real terminal input. Bubble Tea decodes a terminal's ESC prefix into ModAlt, so alt-modified keys arrived as a bare character and common bindings did nothing; the prefix is restored, making Option+Left/Right word motion (alt+b / alt+f) and Option+Backspace word deletion behave as they do in any terminal. Ctrl is preserved as the meta-control byte, and alt+shift+f stays F instead of collapsing to the base rune.
• The terminal scrollbar column is reserved unconditionally, so crossing the scrollback threshold no longer changes the width tmux wraps at — a frame published mid-resize rendered the pane one column too wide, clipping its final column and reflowing it as a blank wrapped line. (td-0818ef)
• The commit-for-merge modal no longer dead-ends on a clean tree. When an agent had just committed in the workspace, the lagging status snapshot let you press Commit against a clean index and hit git's "nothing to commit" as an unrecoverable modal error; the merge/PR workflow now proceeds with a toast explaining that nothing needed recording.
• Quiet live shells read as ◎ live rather than ● running, so a plain shell with a process but no agent activity no longer looks like busy work.

Features

• Agent chips match across surfaces. The workspaces list and kanban reuse the Overview's themed agent presentation — icon, colour, raised fill — and Overview shell cards drop the redundant tmux prefix in favour of the session name.
• The marketing front page was updated to cover recent features.

Features

• The cross-project Agent Overview is on by default. A single board shows every agent workspace across all your projects, not just the one you have open — click the logo or press K to reach it. Rows interleave workspace identity (project, branch, agent) with live inventory (activity state, diff size, PR status), and the board is colour-encoded by state so a glance tells you what is working, blocked, or waiting on you. Refreshes are request-ID'd and per-project trackers are isolated, so one slow project can no longer stall or corrupt another's row, stale navigation results are rejected instead of jumping you to the wrong pane, and sibling worktrees are matched to their real panes. The compact/narrow layouts keep the app header and active tab on one row. (td-1983cb, td-d2e415, td-5feb84, td-a2b217, td-2fb16f, td-a2ec37, td-897e31, td-47321d, td-20f583, td-7e8d0d, td-6b4657)
• Terminals across the app share one model-first component. Workspace panes, shell panes, and the files-plugin inline editor all run on the same terminal model instead of three divergent capture paths: absolute scrollback history is preserved, terminal generation is invalidated on resize, a blank pane falls back to a rendered snapshot rather than flickering empty during reseed, and pane input routing is consistent everywhere. The inline editor inherits all of it, and rejects stale async save results instead of applying them over newer edits. (td-b49d63, td-14a1df, td-d5df75, td-76f993, td-d267fe)
• Workspace creation, merge, and PR lifecycles are recoverable and safe to interrupt. A creation that fails partway preserves its partial state and can be resumed rather than leaving an orphaned worktree; merge preflight, post-create discovery, and other long git operations are cancelled cleanly when you move on, instead of landing their results on a workspace you have already left. Cleanup refuses unsafe targets, merge recovery is bound to the identity it started with, pull revalidates its target first, fork base topology resolves correctly, and containment refusals say plainly why they refused. (td-24d130, td-75360a, td-9ce7db, td-c90334, td-9ce314)
• Diff status is authoritative. The changed-file counts and diff strategy shown on a workspace card come from a captured strategy rather than being recomputed against whatever the tree looks like at render time, so branch commits show correctly and a phantom diff entry no longer appears.
• Agent activity states animate, and each provider gets its own spinner set, so a working agent reads as working at a glance instead of as a frozen frame.
• Grok detection, plus a round of general agent-detection accuracy fixes.

Bug Fixes

• Theme contrast is enforced on every surface text is drawn on, so no theme can produce unreadable text on a coloured background; search match highlights are guaranteed a legible foreground.
• Passive terminal follow is preserved on the live grid — the Overview grid no longer steals follow from a terminal you are watching.
• The workspace terminal cursor is placed from a carried pane split, and the preview header collapses to a single row.
• Panel shortcut input is routed to the right panel; model-owned panel capture is guarded. (td-14a1df)
• Visible terminals are kept current rather than going stale behind the active pane.

Developer

• Releases fail closed on red Go CI instead of relying on a manual checklist item.
• A byte-fed screen-model adapter, tmux fidelity harness, and shadow-comparison canary were built and evaluated against the tmux-owned path; the gate outcome is recorded as HOLD, and tmux retains ownership of bracketed paste at the input seam. (td-b7aa77, td-d7a24f)
• Isolated terminal proof harness hardened: bare control-client socket identity is verified, and the proof driver refuses to run against a shared server. (td-d7a24f)
• A Codex adapter, plus harness-change detection per terminal/workspace.

Features

• Agent activity detection is semantic, not just pattern-matched, and it now drives the kanban board. Working/idle/blocked/done for Claude, Codex, Gemini, Grok, and Antigravity is classified by a real per-provider rules engine (internal/agentactivity) that reads pane titles, the current foreground process, and a bounded "current bottom" window of the screen — not raw scrollback, so resolved historical UI (an old prompt scrolled past) can no longer masquerade as live state. This activity tracker is now authoritative over the legacy tmux-render heuristic for every provider it supports, and the kanban board's lanes and card health/status text are driven from the same presentation function as the list view, so the two can no longer disagree. A worktree's health (missing folder, orphaned session, error, paused) always wins over activity, and a completed run is flagged unseen ("done") only on a genuine transition from working — restart or initial idle stays quiet, and idle observed only because a positively-identified process produced no rule match ("fallback idle") never itself creates an unseen-done badge. (td-8ac0a8, td-e48244, td-eef998, td-defc9c, td-725a7e, td-495065, td-f1b868, td-6e56a6, td-4954e5, td-22b195)
• Five more agents get the same live activity detection: Pi, GitHub Copilot CLI, Cursor Agent, OpenCode, and Amp. Each ships its own rule set (compatibility-tested against Herdr provider manifests) for working/blocked/idle, including recognizing that a help/history/settings overlay or an interrupted turn should retain the agent's last real state rather than reporting idle. Fallback idle — no rule matched a known-live process — no longer downgrades to a "done" completion badge for these five, only for the original four. Terminal-control snapshots (tmux control-mode) now carry pane title and current-command metadata end-to-end, so these probes get the identity they need without falling back to slower polling; the "fallback idle can never announce completion" rule stays scoped to expanded agents, and a plugin-wide fallback idle default is scoped to only the panes actually expanded on screen so a collapsed row can't borrow another row's read. (td-30281f, td-31ab2b, td-52abdf, td-a5670d, td-8625a6)
• make install-local / make install-worktree / make use-homebrew manage a Homebrew-linked development binary safely. scripts/dev-install.sh builds and swaps the linked sidecar binary in place, refuses to run install-local from a branch or a linked worktree (use install-worktree when that's deliberate) so an incidental checkout can't silently become "the" dev binary, and make install-status / make test-dev-install report and prove the switching logic against an isolated fake Homebrew prefix. make install remains the old unmanaged go install path. Mirrors the switching tool td just shipped. (td-d2466a)

Bug Fixes

• Git status parsing is hardened for large trees and copy/rename cases. git diff --numstat is now parsed as NUL-delimited (-z) output instead of scanning tab-delimited lines with a regex, which broke on filenames containing tabs or newlines and matched staged/unstaged diff stats to entries by filename instead of by request; renamed-and-copied entries (C) are now distinguished from pure renames and staged/unstaged flags are read from both status columns instead of assuming a rename is always fully staged. Untracked-file line counting (a separate batched wc pass) was removed as redundant. Proven at scale against large working trees. (td-07bb70)

• Git status snapshots can no longer be torn or stale by the time they render. Every status/history/diff/preview load is now a request-ID'd, immutable snapshot: a load in flight when another refresh arrives no longer overwrites in-place fields the UI is mid-render against, a stale response is dropped instead of applied, and a refresh that arrives while one is already in flight is coalesced into a single dirty flag rather than double-fetching. Errors from a failed refresh surface as a toast instead of silently leaving the old tree on screen with no indication it's out of date. (td-403712)

• The git file-system watcher tracks the actual administrative files git is touching, not a hardcoded .git/ layout. Paths are resolved with git rev-parse --git-path so linked worktrees (whose HEAD/index live outside the common .git directory) are watched correctly, refs/ is walked recursively so nested ref directories are covered, and index-only churn versus HEAD/ref changes (which invalidate commit history) are classified precisely instead of both triggering a full refresh-and-reload. Stage/unstage operations are serialized through a single write executor with proper async result handling, replacing a debounce-and-batch shortcut. (td-ce6c26, td-ee1242)

• Stage-all/unstage-all and other bulk git write operations run asynchronously instead of blocking the UI thread, coalescing rapid repeated calls and reporting failures without corrupting the file list. (td-ee1242)

• Stale startup and dead-code debt removed from the git plugin. Sidecar's .gitignore scaffolding entries are now written only when the user explicitly initializes a new repo from Sidecar, not merely when opening an existing one; a stash-index placeholder that called exec.Command("echo") purely to satisfy an unused import was replaced with real index parsing; several unused stash helper functions were deleted. (td-c35648)

• A second sidecar can no longer make your running shells disappear. The shell manifest is a file every sidecar instance on the machine shares, and startup used to prune every entry whose tmux session it could not personally see — so a sibling worktree, or a test run on its own tmux socket, would quietly rewrite shells.json down to its own sessions. A live instance watching that file then dropped six shells from the Workspaces sidebar whose tmux sessions were still running, and r did not bring them back. Persisted definitions now record which tmux server owns them, absence is only treated as death when this instance could actually have discovered the session, in-memory shells that are alive locally survive any manifest another instance writes (and are healed back into the file), and r re-runs discovery so surviving sessions come back without restarting the app or hand-editing JSON. (td-8d18de)

• A shell that comes back to life is usable again. When a session that had gone missing reappeared, the sidebar row switched from offline to live but never regained its terminal, so opening it silently did nothing until the app was restarted. Reviving a shell now rebuilds its session and starts polling it. Related: a sibling worktree's shells are no longer listed in your sidebar as offline rows you could never open (they are still preserved in the shared file), a failed tmux list-sessions is no longer read as "nothing is running" — nothing is pruned when tmux cannot be reached — and shell manifest edits merge with what is on disk instead of overwriting a rename another instance just made. (td-8d18de)

Developer

• -config now also relocates state.json and debug.log. They live next to config.json, so sidecar -config ~/somewhere/sidecar.json reads and writes its persisted UI state and debug log from ~/somewhere/ rather than ~/.config/sidecar/. This is what makes -config a real isolation lever for proof runs. If you pass -config in normal use and want your existing preferences, move state.json next to the config file you point at. (td-8d18de)
• go test is isolated from the real state tree by default. Any test binary is treated as asserting isolation, so a package that forgets to redirect XDG_STATE_HOME now gets a refusal instead of quietly creating directories in ~/.local/state/sidecar/projects. A test that deliberately exercises the ordinary unisolated path sets SIDECAR_ALLOW_REAL_STATE=1 (with HOME pointed at a temp dir). (td-8d18de)
• Proof runs are isolated on both axes, and fail closed if they are not. "Never restart the default tmux server" turned out to be necessary but not sufficient: the run that caused the bug above held a private tmux socket and still resolved the developer's real ~/.local/state/sidecar. Sidecar now refuses to read or write anything under the real state or config tree when SIDECAR_ISOLATED_STATE=1 is set, exiting at startup rather than touching a byte; SIDECAR_DIAG_PATHS=1 (implied under asserted isolation) prints the resolved state, config, tmux socket and manifest paths. scripts/tmux-drive.sh now isolates TMUX_TMPDIR, XDG_STATE_HOME, XDG_CACHE_HOME and -config under one run root, adds a paths subcommand, and tears the inner server down by explicit socket path; scripts/tmux-screenshot.sh refuses to run un-isolated, and tmux-drive.sh start refuses to take over a run root another driver is already using (set SIDECAR_DRIVE_RUN_DIR per agent, or SIDECAR_DRIVE_FORCE=1). A cross-instance regression suite proves an isolated instance cannot evict a peer's live shells or write the real manifest, and the headless-testing guide, AGENTS.md and PRIVACY.md now document both isolation axes (including that XDG_CONFIG_HOME moves nothing). (td-8d18de)

Dependencies

• Updated td to v0.56.0. Review stamps cleared by superseded-approval handling now sync between machines instead of being stranded on the clearing client. The monitor displays timestamps and due/defer dates in local time with civil-day math, so a DST transition can no longer mislabel tomorrow as today. Sidecar needed no change for this.

Features

• Grok is a first-class workspace agent. Create and start workspaces with Grok (grok, skip-permissions via --always-approve) alongside Claude, Codex, and the rest. Configure which agents appear and in what order with plugins.workspace.agents (for example ["grok", "claude"] to hide Copilot and put Grok first); create/start pickers, defaults, and shell lists all honor the allowlist, and an unknown default falls back to the first listed agent.
• Embedded terminals render at their true pane size. Tmux panes are sized and mapped through hit testing so the program inside lays out for the visible area rather than a mismatched rectangle; letterbox padding no longer steals editor clicks.
• Focus-gated ownership lease for shared tmux geometry. When several sidecar instances (or a sidecar and an attached client) share a session, geometry ownership follows where the user is — focus and attach hold ticks with bounded refresh, dead leases are reclaimed, and an attach no longer claims permanent authority. Held sessions read input back out of tmux so a background holder does not starve the active client.

Bug Fixes

• Global shortcuts show up in the command palette. Hard-coded app bindings (i, W, #, r, ctrl+c) are registered in the keymap so discovery matches what the app actually handles.
• Open Issue Enter uses the sole search result when the cursor has not been moved, instead of submitting a partial typed query.
• The agent config picker list is pinned for the modal lifetime so a config reload cannot reshuffle options under the cursor mid-choice.
• Modals take keyboard focus from a live terminal so typing goes to the dialog rather than the session underneath.
• Terminal view and cursor stay on one pane-row anchor; geometry decisions use user presence rather than focus alone; failed marker reads are treated as absence of evidence rather than proof of a hold.

Developer

• Streamlined releases. RELEASE_VERSION=vX.Y.Z make release fail-closed-preflights (clean tree, live main, changelog entry, no replace, tag absence), pushes an annotated tag, waits for CI, and verifies or resumes the Homebrew formula. CI runs verify → GoReleaser → template-rendered Formula/sidecar.rb with downgrade/idempotency/race guards. See docs/releasing.md.

Features

• Clicking the shell or agent output makes the terminal live. A click focused the pane but left it inert — entering interactive mode needed a separate enter/i/E press, so the pane looked active while typing went nowhere, and the wheel paged sidecar's own capture buffer instead of reaching the running app, which meant scrollback in TUIs like the Claude Code harness ignored it entirely. A plain click now enters interactive mode, matching enter; shift and alt clicks still fall through to read-mode drag selection, and the click is a no-op when there is no live session.
• Drag a row in the files tree to move the file or folder. Press on a row and move two cells in any direction to pick it up; drop it on a directory row to move it there, or on a file row to move it alongside that file, the way Finder and VS Code behave. Resting over a collapsed folder for a moment springs it open so one gesture can reach a nested destination, dragging to the top or bottom of the pane scrolls the tree, and esc cancels a gesture in flight. Moves that would corrupt the tree — a folder into itself or into its own subtree — and moves that would do nothing are refused with a toast saying why, and the same rules now back the keyboard m dialog, which previously reached os.Rename and reported a raw invalid argument. Drag-to-move is enabled for everyone: a press that moves less than two cells is still an ordinary click. There is no undo, so nothing moves unless the row was on screen when the button was released.

Bug Fixes

• Clicks in the files plugin land on the row you are looking at while an input bar is open. The tree's clickable rows were registered one row too high per open bar, and the move dialog's path-suggestion dropdown was not counted at all — so with three suggestions showing, every row was off by five. The same stale measurement shifted click and drag-selection in the preview pane by a line, and put the suggestion list's own click targets a row above the suggestions they named. Keyboard tree scrolling used a third, different measurement, which could leave the cursor on a row that was never drawn.
• Mouse scrolling and clicks work in the td plugin again. td's monitor computes its panel bounds only when it receives a window-size message, and since the monitor model is now built asynchronously it is adopted after the app has already broadcast that size — so the new model never saw one. Panel bounds stayed empty, every hit test missed, and the wheel and clicks silently did nothing until the terminal was resized.
• The files tree scrollbar stays in its own column. It jumped left to hug the longest filename whenever no full-width highlighted row was on screen — during a drag, and any time the cursor was scrolled out of view.
• Manual search inputs accept spaces.

Dependencies

• Updated td to v0.55.0. Log rows written as side effects — the progress note td unstart records when releasing a claim, and the auto-cascade and auto-unblock notes — now sync between machines instead of being stranded forever on the machine that created them. A transition to open releases the implementer claim on every surface, including the API, which had never received the earlier reopen and unblock fixes. ERROR: and Warning: diagnostics moved from stdout to stderr so --json output is parseable. Sidecar needed no change for this and quietly benefits: the issue preview and search commands unmarshal td's stdout directly, which an error line used to corrupt, and their error extraction already fell back to stderr.

Features

• The file browser now tracks filesystem changes as they happen. Sidecar watches the project root and expanded directories, coalesces bursts of creates, deletes, renames, and writes, and refreshes the tree without waiting for the tab to lose and regain focus. Changes also invalidate background file previews, quick-open results, and path-completion data so every file-browser surface stays aligned with the disk. The watcher is bounded to avoid excessive file descriptors on macOS and is enabled by default behind the files_auto_refresh feature flag.

Performance

• Tree rebuilds, quick-open scans, and path-completion scans now run outside the UI update path while the previous results remain visible. Navigating to a known file descends only through the directories in that path instead of loading the entire project tree.

Bug Fixes

• Async tree refreshes preserve directories expanded and files selected while a scan is running, reject stale results, and continue listening while the inline editor, search, or a modal is open. Recreated directories are re-watched, project switches stop the old watcher, and cache scans can no longer clear one another's dirty state.

Dependencies

• Updated td to v0.54.0, adding review attribution and sync support along with monitor input, CLI error reporting, and terminal-output sanitization fixes.

Features

• The terminal window and tab are named after the active project. With several sidecars open at once, the tab bar now says which is which — sidecar, td [charm] — instead of leaving every tab labelled by the shell, and the name follows along when you switch projects or worktrees from inside sidecar. The format is configurable through the new ui.terminalTitle template ({project}, {worktree}, {plugin}, {dir}); set it to "" to leave the title untouched, and outside a git repository it falls back to the directory name rather than clearing what your shell set. The previous title is restored on exit in terminals that support the title stack, and a title set by an editor or an attached session is taken back when you return. Under tmux this sets the pane title — see the docs for surfacing it in the status line.

Bug Fixes

• Scrolling an embedded terminal scrolls the program running in it. When the program has enabled mouse tracking — Claude Code, vim with mouse=a, htop — wheel notches now reach it as SGR mouse reports, the way any other terminal emulator delivers them. Previously every notch scrolled sidecar's own view of the captured pane instead, which was worst for full-screen programs: they draw their own scrollback inside the pane and leave tmux's history empty, so scrolling slid the viewport across the live frame and left the layout looking torn. Programs that track no mouse are unaffected and keep scrolling the captured scrollback, and alt+wheel still scrolls it for programs that do.

Bug Fixes

• E enters interactive mode again. The key was listed in the keymap and advertised by both the preview hint line and the command palette, but nothing handled it — so it did nothing, and because the workspaces tab kept interpreting keys, whatever you typed next was read as workspace shortcuts (typing whoami after it opened the issue picker). enter was and remains the primary binding.

Dependencies

• Updated td to v0.53.0, which fixes several issue-query bugs.

Features

• Embedded terminals are driven by tmux control mode. Sidecar keeps a control connection to the visible terminal and re-renders when tmux says the screen changed, instead of capturing it on a timer. The polling path is retained and resumes automatically whenever control mode cannot start or its client dies.
• Embedded terminals use the host terminal's own cursor rather than a drawn block, so shape, blink, and hidden-cursor states match what the program running inside actually asked for.
• Scroll back through the full tmux scrollback. Older ranges are fetched on demand as you scroll past what is loaded; the hint line reports how many older lines remain and how far back you are from the live edge.
• Search terminal scrollback. Press / (or ctrl+shift+f while interactive) to search, n/N to step through matches, esc to clear. Search covers the complete tmux history, not only the ranges you happen to have scrolled through.
• Select terminal output with the mouse. Drag to select, hold alt for a rectangular selection, double-click for a word, triple-click for a line, ctrl+a for everything. Set plugins.workspace.copyOnSelect to copy as soon as a drag ends.
• URLs in terminal output are underlined and clickable. Hyperlink escape sequences present in the output itself are stripped and re-synthesized only for URLs that pass a safety check, so untrusted output cannot make a link point somewhere other than the text it displays.
• ctrl+n creates a shell session directly from the workspaces tab, skipping the type-selector modal. It uses plugins.workspace.defaultAgentType when one is configured and creates a plain shell otherwise; it never passes an agent's skip-permissions flag, so use n → Shell when you want that. The hint appears in the workspaces footer next to New.
• New plugins.workspace.autoCreateShell setting (default off). With it enabled, the first time you focus the workspaces tab in a session sidecar creates a shell for you, so a terminal is ready for quick tasks without going through the create modal. It only fires when no shell sessions exist — shells whose tmux sessions survived a restart are reattached as before — and it leaves the sidebar selection where it was rather than jumping to the new shell. Nothing is created until the tab is focused, so startup is unaffected when you open on another tab.

Bug Fixes

• Typing fast in an embedded terminal no longer transposes characters. Every keypress returned its own command, and those run concurrently — so two keys typed in quick succession raced into tmux and could arrive out of order (whoami landing as whoaim). Keystrokes now go through a per-session queue that fixes their order where the key is handled, not where its command happens to be scheduled. Pastes share the queue, so pasted text can no longer interleave with surrounding keys.
• The terminal cursor is drawn on the line you are typing on. The rendered buffer is scrollback followed by the pane's rows, but the cursor's row was mapped straight onto a display row as if the buffer's tail were the pane — so the cursor floated above the live line by however much scrollback the capture carried. On a fresh shell that was one row; after quitting a full-screen program like vim it was many, which is the "cursor stays at the top of the terminal while I type further down" report.
• The terminal scrollbar sits at the right edge of the pane. It was aligned to the longest rendered line instead, so on a mostly-empty terminal it appeared right after the shell prompt and crept rightwards as you typed. Full-width lines could also push the joined block past the pane and wrap it, shifting every row down by one.
• Interactive mode shows a cursor when entered from the sidebar. The native cursor and cell-motion mouse reporting were gated on the preview pane being active, and entering interactive mode left the sidebar active — so the session ran with no visible cursor at all. The previous pane is restored on exit.
• Editors opened in a workspace shell get the full pane. Shell sessions were created without a size, so tmux used its 80x24 default and anything started before the follow-up resize laid itself out for 24 rows.
• The inline file editor gets the height it is displayed in. Both the file browser's and the notes' inline editors created their tmux session at the whole plugin rect while rendering into a viewport four to five rows shorter, pushing vim's status and command lines out of view.
• Terminal selection highlights and search matches stay on their lines once older scrollback has been loaded. The renderer could be handed a base of 0 for a buffer that actually started further down tmux's history, offsetting every highlight by the amount of loaded scrollback.
• The plugin active at startup is now marked focused. SetFocused only ran when switching tabs, so whichever tab sidecar opened on reported itself unfocused — which, among other things, made it poll its tmux sessions at the slower background interval until you navigated away and back.
• Footer hints with equal priority no longer sort nondeterministically; they now follow the order the plugin declares them in.

Developer

• Added scripts/tmux-drive.sh, which runs sidecar on its own tmux socket, sends it keystrokes, and captures the screen as text and PNG — the terminal fixes above were all reproduced and verified this way, without a human at the keyboard. docs/guides/headless-testing.md covers it, including how to see the native cursor (which capture-pane cannot) and the tmux coordinate spaces the terminal code works in. AGENTS.md is now the single entry point for agent instructions.

Interface

• Removed the ASCII tree from the main worktree preview. The pane now leads with the text and carries hints for both n (new workspace) and ctrl+n (new shell).

Bug Fixes

• Claude Code and Cursor sessions no longer go missing when the project sits under a symlinked path. Both adapters locate sessions by deriving a directory name from the project path — Claude Code by substituting characters, Cursor by hashing the string — and neither resolved symlinks first. Sidecar passes the main worktree path reported by git worktree list, which is resolved, while both tools record the working directory as the shell saw it. Where those disagree the lookup landed on a name that does not exist and the conversations tab reported no sessions at all. Both adapters now try the path as given and its resolved form, matching what the Warp, Kiro, Pi, and Pi Agent adapters already did.
• The Claude Code adapter now honors CLAUDE_CONFIG_DIR. Claude Code uses it to relocate its config directory; sidecar only looked in ~/.config/claude/projects and ~/.claude/projects, so a relocated install appeared to have no sessions.

Performance

• Startup is roughly 30x faster. Time to a usable first frame went from ~4.3s to ~0.1s on the machine this was profiled on. The gain is larger on machines running an endpoint security agent (CrowdStrike and similar), where every file open and process spawn carries a fixed tax and the old startup path did a great many of both.
  • Conversation adapter detection no longer runs before the first frame. It used to probe all twelve adapters serially inside plugin init, and probing Codex alone walks every rollout file in ~/.codex/sessions — 3.5s against a few thousand sessions. Detection now runs asynchronously and probes adapters concurrently, so it costs the slowest adapter rather than the sum, and the tab shows its loading skeleton until results arrive.
  • The Codex, Pi, and Amp adapters probe session files newest-first and stop at the first match, so opening a recently used project reads a handful of files instead of the whole history.
  • The td tab builds its embedded monitor (which opens the task database) asynchronously instead of during init.
  • Terminal graphics-protocol detection no longer queries the terminal at startup. The queries cost ~0.5s in escape-sequence round-trips and two tmux subprocess spawns, and nothing consumed the result — image previews always render with Halfblocks. The protocol is now read from environment variables.
  • Dropped redundant git rev-parse --git-dir prechecks before git worktree list and git remote get-url, halving the subprocess spawns on those paths.

Features

• Added SIDECAR_STARTUP_TRACE for diagnosing slow launches. Set it to stderr to print a phase-by-phase startup timeline (or 1 to write it to the debug log), and SIDECAR_STARTUP_TRACE_DELAY to dump the trace later so asynchronous startup work is included.

Bug Fixes

• Fixed a potential crash from concurrent access to the OpenCode adapter's project index, which was reachable whenever session loading and file watching ran at the same time.
• A panicking conversation adapter now disables just that adapter instead of taking down the application.

Dependencies

• bump td to v0.51.2 — local session state store, worktree identity on sessions, session keying by context ID for sub-agent independence, --json output across the CLI mutation commands, project slugs and invitations, plus fixes for sync conflict false-positives, handoff autosync stalls, and SQLite timestamp serialization.

Features

• Add an Oh My Pi (OMP) conversation adapter for sessions stored under ~/.omp/agent/sessions, reusing the Pi Agent JSONL parser with OMP's current project-path encoding.

Bug Fixes

• Preserve custom Pi Agent-compatible adapter identity on returned sessions, so OMP sessions are labeled as OMP instead of Pi Agent in conversation lists and targeted refreshes.
• Resolve symlinks when matching Pi Agent project session directories, fixing macOS paths such as /tmp resolving to /private/tmp.

Dependencies

• bump td to v0.47.2 — normalizes issue IDs before FK-constrained writes.

Bug Fixes

• td monitor: capital-letter keyboard shortcuts now work again. After the v0.85.0 Charmbracelet v2 upgrade, Y (copy task ID) and every other shift-bound shortcut in the embedded td monitor silently did nothing. In Bubble Tea v2 a shifted printable key arrives as the unshifted code plus a shift modifier, so td's keymap matched against "shift+y" instead of "Y". Fixed upstream in td and pulled in via the dependency bump below.

Dependencies

• bump td to v0.47.1 — fixes the capital-letter shortcut regression in the monitor keymap (KeyToString now uses Key.String(), mirroring sidecar's own keymap fix).

Dependencies

• Charmbracelet v2 migration: upgraded to the charm.land v2 stack — lipgloss v2.0.3, bubbletea v2.0.7, bubbles v2.1.0, glamour v2.0.0 (huh v2.0.3 transitively, via td). Bubble Tea v2 ships a faster renderer and a declarative tea.View; lipgloss colors moved to image/color.Color; key/mouse handling moved to the v2 message model (KeyPressMsg, MouseClickMsg/MouseWheelMsg). No intended behavior change — a mechanical migration verified against the full test suite.
• bump td to v0.45.0 — itself rebuilt on the Charmbracelet v2 stack, so sidecar's embedded td monitor sub-model now shares the same v2 tea.*/lipgloss.* types. The local development replace directive was removed.

Dependencies

• bump td to v0.44.0 — SQLite configuration stabilization: foreign_keys=ON enforced on CLI issues.db with migration 30 orphan cleanup + schema ON DELETE CASCADE on child relations; centralized SQLite opener (OpenSQLite) with uniform pragmas; PASSIVE WAL checkpoints on Close; removed redundant manual cascade emulation in internal/sync/events.go; new td doctor fk orphan audit (gated by TD_FEATURE_SYNC_CLI=1); new TD_MONITOR_DBPOOL_DEBUG env var for monitor connection-leak tracing; td import tolerates forward-referencing deps via per-transaction FK toggle

Features

• feat: full-file diff view with minimap (#232)
• feat: two-pane diff tab with drag-to-resize (#232)
• feat: git sidebar line stats (#232)
• feat: split terminal panel with Ctrl+T toggle (#232)

Dependencies

• bump td to v0.43.0 — 24 bug fixes: atomic lossless import, UpdateIssue missing fields, timezone-aware defer/due filtering, RemoveDependencyLogged wrong depID, DeleteBoardLogged atomicity, RateLimiter goroutine leak, CORS missing methods, snapshot stat error, DB connection leaks, form scroll over-run, modal click detection, in-progress panel header count, RFC3339Nano sync parsing, sess nil guard, escapeJSON completeness, stdin pipe size guard, trusted proxy XFF spoofing, CreateUser admin TOCTOU race, backfill false positive, autosync tx leak, singleflight snapshot dedup

Dependencies

• bump td to v0.42.2 — 14 bug fixes: SSE nil-validator panic, work_session_issues sync, non-atomic undo, rows.Err() propagation, timestamp parse, non-transactional migration, snapshot race, StatusFilter/board editor data races, stale syncState, CLI reject validation, HelpFilter UTF-8, preview count, copyFile durability

Dependencies

• chore: bump td to v0.42.1 — fixes lossless import round-trip for all issue fields and associated data (#64)

Features

• Agent-powered PR description generation in merge workflow (#167)
• Configurable default agent type and .sidecar-agent-start override per worktree (#198)
• OpenCode adapter backward-compatible conversation updates (#199)

Bug Fixes

• Prevent tmux server exit when all sessions are killed
• Fix centralized agent file tests to use correct storage path

Dependencies

• Bump td to v0.42.0

Features

• Add GitHub Copilot CLI adapter for conversations plugin

Bug Fixes

• Restore mobile sidebar nav visibility (#220)
• Resolve worktree path from ProjectRoot, not WorkDir (#174) (#218)
• Fix task title truncation in td view (#215) (#217)

Documentation

• Worktree setup hooks (#219)

Developer

• Add pre-commit hooks for gofmt/vet/build (#216)

Features

• Add Amp agent support for workspaces (#195)
• Make PR URL clickable and add yank shortcut in merge modal (#164)

Bug Fixes

• Resolve CI lint and test failures (#214)
• Remove stale sessionIndex references in opencode adapter tests (#212)
• Add all sidecar state files to .gitignore on init and startup (#211)

Dependencies

• Updated td to v0.39.0

Features

• Open In modal to open projects in IDEs (#200)
• Centralized project data storage under ~/.local/state/sidecar with migration (#197)
• Detect .todos file vs directory conflict in onboarding (#206)
• Agent restart uses chosen agent rather than defaulting to Claude (#192)

Bug Fixes

• Use standard diagnostic status strings for fsnotify watcher (#158)
• Hierarchical branch crash, git hangs, and adapter timeouts (#136)
• Git init bug in test, remove dead kiro code (#148)
• Opencode sandbox path matching for bare-repo worktrees (#204)

Bug Fixes

• Fix git locking errors in background operations by using --no-optional-locks (PR #186 by @borisvu)
• Fix tmux agent reconnection type handling (PR #150 by @jacola)

Added

• MIT LICENSE file (Issue #182)

Dependencies

• Updated td to v0.38.0 — approval workflow fix

Bug Fixes

• Shift+Enter and semicolon key fix for Ghostty terminal (PR #171 by @boozedog)

Features

• Kanban board view — press V in board context for overlay, f to toggle fullscreen
• 7 status columns: Review, Rework, WIP, Ready, P.Review, Blocked, Closed
• Per-column independent scrolling with scroll indicators
• Form autofill/autocomplete for Parent Epic and Dependencies fields
• InProgress and PendingReview now have distinct categories (previously lumped into Ready)

Dependencies

• Updated td to v0.37.0

Dependencies

• Updated td to v0.35.0 — adds GTD-style deferral (td defer, td due, temporal list filters, monitor modal defer/due display)

Bug Fixes

• Prevent refreshSessions from overwriting concurrent session list updates
• Improve update error modal UX with actionable info
• Detect brew upgrade false-positive "already installed" response
• Add brew update before brew upgrade in self-update flow

Features

• Pi Adapter: View Pi AI agent sessions (OpenClaw) in the conversations plugin, with session classification (interactive, cron, system), source channel detection, and CWD-based project matching

Documentation

• Add Pi to supported agents on website homepage, conversations plugin docs, and intro page

Dependencies

• Update td to v0.33.0

Features

• Amp Code Adapter: View Amp Code IDE threads in the conversations plugin, with token usage, tool calls, and project matching
• Kiro CLI Adapter: View Kiro CLI conversations from SQLite storage, with message parsing and project detection

Bug Fixes

• Fix file search (/) hanging on large projects by reusing Ctrl+P file cache with fuzzy matching (#107)

Dependencies

• Update td to v0.32.0

Features

• Homebrew Formula: Install via brew install marcus/tap/sidecar — builds from source for native Apple Silicon performance

Improvements

• Better PR fetching in git plugin

Features

• Add ProjectRoot to plugin.Context for worktree-aware shared state
• Convert 17 docs/guides into .claude/skills for AI agent discovery
• Focus files pane when clicking markdown links

Bug Fixes

• Fix splitFirst OOB panic by using strings.SplitN
• Resolve td root via git-common-dir for external worktrees

Improvements

• Resolve all 360 golangci-lint issues across codebase
• Make lint-all CI-blocking

Dependencies

• Update td to v0.31.0

Features

• Merge notes plugin behind feature flag
• Add nightshift to sister projects section

Bug Fixes

• Fix git search modal shortcut scoping while typing
• Fix for adding projects

Improvements

• Refactor text input shortcut gating to plugin capability
• Show git plugin no repo state

Dependencies

• Update td to v0.30.0

Documentation

• Update UI guide for plugin text input capability
• Updated adapter guide

Bug Fixes

• Fix Claude Code adapter not detecting sessions in paths with dots or underscores (#96)
  • Paths like /home/user/github.com/project now correctly match
  • Paths like /home/user/my_project now correctly match

Performance

• Further FD tuning with codex integration

Features

• Tiered file watching for FD reduction (reduces open file descriptors)
• Click worktree indicator in header to open worktree switcher
• Alt+C copy shortcut in file preview mode and inline edit
• Show copy hint on first text selection in file preview

Bug Fixes

• Replace adapter Watch() with tiered watcher for FD reduction
• Return ToastMsg directly instead of ShowToast cmd

Internal

• Unify ToastMsg types into msg package
• Add FD reduction patterns to adapter-creator-guide

Features

• Character-level text selection in file browser
• Shared text selection module extracted to internal/ui
• Documentation migrated to sidecar.haplab.com with Haplab branding

Bug Fixes

• Fix files line swallowing in file browser
• Fix text selection in line-wrapped files

Features

• Stream session results per-adapter for incremental loading
• Client-side session pagination
• Animated braille spinner for adapter loading indicator
• Loading indicator while adapter batches are still arriving
• Scrollbar component (RenderScrollbar) with dedicated theme keys
• Scrollbars in file browser, git status, conversations, workspace sidebar, and modal viewport
• Auto-scroll modal viewport to focused element on Tab
• Target branch selector for merge workflow
• Fetch remote PR as workspace (F key)

Bug Fixes

• Improved drag handle between panes
• Parallelize adapter loading and fix scroll-to-load-more
• Fix conversation and viewport line backgrounds
• Fix modal background color and scrollbar characters
• Scroll to focused element on SetFocus in modal
• Persist worktree base branch to .sidecar-base file
• Resolve main worktree path for .td-root
• Handle enter key on orphaned worktrees
• Dynamic dimensions for inline editor session
• Save/restore terminal state around editor/tmux launch
• Guard against non-terminal stdout at startup
• Tmux resize and dimension fixes
• Fix update preview modal not rendering for td-only updates
• Scrollbar resizing fix
• Various bug fixes from review session

Dependencies

• Updated td to v0.29.0

Features

• Breadcrumb navigation in git diff view

Bug Fixes

• Fix showClock config not disabling clock in header bar
• File preview behavior improvements
• Suppress stray [ characters leaked from mouse motion CSI sequences using time-gating

Dependencies

• Updated td to v0.28.0