Development Timeline

Help Agent and agent intelligence

• Help Agent — dedicated workspace for answering Canopy usage questions, pre-configured with a free Canopy document search MCP
• Per-agent assistant model selection in settings — choose which model powers each agent type
• Agent availability status shown in the panel palette and setup wizard
• Granular agent state detection — exited, approval-waiting, and working states tracked independently
• Custom CLI arguments per recipe terminal for fine-grained agent configuration

Performance overhaul — 29 PRs optimizing startup, rendering, and memory

• Lazy loading for HybridInputBar, NewWorktreeDialog, and non-critical UI components
• CSS layout containment and content-visibility for faster composite and paint
• Compile caching, singleflight cache, and adaptive batching for terminal output
• MessagePort ACK gates and byte-count carry for zero-copy I/O tuning
• End-to-end startup pipeline wired and measured — initial hydration no longer blocks rendering

Multi-window support, Electron 41, and terminal session transfer

• Open projects in independent windows with per-window workspace hosts and state persistence
• Blue-green workspace swap for seamless project switching without flicker
• Terminal session transfer — move an agent session mid-task to a different worktree
• Adaptive resource profiles scaling memory and CPU across active and background projects
• Electron 41 upgrade with React 19.2 Activity API for workspace view caching

Theme refinements, sound system, and onboarding redesign

• All 14 themes individually audited and refined — light theme contrast, background blur, and dialog title bar fixes
• Sound system with audio cues for agent completion, waiting, and all-clear events
• Streamlined 2-step onboarding with redesigned agent setup wizard
• Pre-agent file snapshots with one-click rollback to restore pre-run state
• Plugin system foundation — manifest schema, panel loader, toolbar button extensions

Windows support, project management, and workspace UX

• Full Windows platform support with native git credentials, system requirements checks, and E2E coverage
• Clone GitHub repos directly from within Canopy with improved clone dialog
• Batch worktree creation from multiple selected GitHub issues
• Project switcher redesigned with frecency scoring and MRU ordering
• Renderer crash recovery with React 19 error boundaries and error classification
• Nightly update channel support alongside the stable release track

v0.5.1–v0.5.3 — Crash recovery, disk monitoring, accent rebrand, Liquid Glass icon

• Renderer crash recovery with per-panel selective restore and safe mode boot
• Disk space monitoring with low-space alerts in the status bar
• Accent color rebranded to #36CE94 across the full design system
• Liquid Glass app icon for macOS 26+

v0.5.0 — 14-theme system, bulk command center, memory resource management

• 14 built-in themes across dark and light variants with system-preference auto-switching
• Bulk Command Center — send a command or recipe to multiple worktrees simultaneously
• Adaptive memory resource profiles across active and background projects
• Custom Canopy tree icon set

v0.4.0 — 12 nature themes, Cursor CLI agent, workflow engine, WebGL renderer

• 12 nature-inspired dark and light themes with unified theme selector
• Cursor CLI added as a fifth supported agent alongside Claude, Gemini, Codex, and OpenCode
• Workflow engine with DAG-based task definitions and execution tracking
• WebGL terminal renderer upgrade for improved performance

v0.3.0 — Worktree sidebar redesign, voice input improvements, project relocation

• Worktree sidebar redesigned with improved filtering, sorting, and drag reorder
• Voice input improvements — word-level streaming and AI correction
• Project relocation support — move a project directory without losing state

v0.2.0 — Review Hub, voice input, MCP server, crash recovery, notification center

• Review Hub — in-app git staging, commit, and push without leaving Canopy
• Real-time voice input via Deepgram with paragraph detection
• Per-project MCP server configuration
• Crash recovery with safe mode and agent state snapshots
• Notification center for agent completion and attention-required events

Security hardening — Electron fuses, CSP lockdown, IPC rate limiting

• Hardened runtime security defaults and Electron Fuses with code signing enforcement
• Strengthened CSP across all sessions
• IPC rate limiting with error sanitization

UX polish — OS-specific keyboard shortcuts, guided Git setup

• OS-specific keyboard shortcut labels and restore-defaults option
• Guided Git setup wizard for new projects
• Tab button in two-pane split mode

Auto-updater with GitHub Actions release pipeline

• electron-updater integration with R2 publishing
• GitHub Actions release workflow
• In-app update notification UI
• Git file watching for instant sidebar updates

Dev preview architecture rewrite

• Replaced DevPreviewService with stateless UrlDetector
• Panel-owns-process model with smart dev server discovery
• Persistent server state across project switches

JetBrains-style action palette and component refactoring

• Double-Shift trigger for action palette
• Attach GitHub issues to existing worktrees
• Extracted shared hooks (useSearchablePalette, useAnimatedPresence)

Project switching reliability and dev preview improvements

• Persist zoom levels, input bar content, and active worktree across switches
• Dev preview migrated to terminal-first model

Agent monitoring — conflict radar, SLA timers, event-based coordination

• Conflict radar warns when multiple agents edit the same files
• SLA timers showing agent working duration in panel headers
• "Attention Required" strip for blocked or waiting agents
• Full pub/sub event system with one-shot listeners and auto-cleanup

Agent monitoring features and Assistant polish

• Agent filters by state and worktree
• Retry button for Assistant failures
• Request/response logging for debugging

Canopy Assistant — built-in AI coordinator with multi-step tool calling

• Vercel AI SDK integration with multi-step tool calling
• Execution log aesthetic with terminal state change listeners
• DAG-based task queue with capability-based agent routing
• Worktree-aware context injection, background message processing

Build infrastructure and security hardening

• Node version pinning with committed lockfile
• Trusted renderer origin enforcement
• safeStorage for project environment variables
• Recipes tab in Project Settings

Tab groups — stack panels into tabs with drag reorder and keyboard nav

• Full panel tabbing system in grid cells and dock slots
• Drag to reorder, double-click to rename, duplicate with "+" button
• Enforced worktree invariant across tab groups
• Persisted and hydrated across restarts

Slash commands — /github:create-issue and /github:work-issue builders

• Core command infrastructure with picker UI
• Multi-step issue builder and work-issue command
• Project-level command overrides with custom prompts
• Resizable two-pane split layout with per-worktree persistence

Browser panels, panel grid rebranding, and dock evolution

• Browser panels migrated from iframe to Electron webview
• Zoom controls, native context menus, proper session isolation
• "Terminal grid" renamed to "panel grid" reflecting the app's evolution
• Interactive slash command chips with hover info

Terminal subsystem modularization

• TerminalInstanceService, TerminalProcess, and pty-host decomposed into focused modules

Major stability and security sweep — ~40 bug fixes in 2 days

• Race conditions, OOM from agent output, IPC contract drift fixes
• Secret redaction failures and terminal state leak patches
• SVG XSS prevention and IPC payload validation
• Cross-project agent state monitoring with tiered polling

OpenCode support, quick project switcher, background project persistence

• Fourth agent added alongside Claude Code, Gemini CLI, and Codex CLI
• Quick project switcher palette (Cmd+Alt+P)
• Dock modes: expanded, slim, and hidden with auto-collapse

Panel system — Notes panel and Dev Preview with live browser

• Content grid generalized from terminal panes to typed panels
• Notes panel with markdown notepad for agent instructions
• Dev Preview panel with embedded browser and auto dev-server management
• Terminal Recipes for saved agent + prompt + dev command templates
• GitHub integration with PR badges, repo stats caching, and issue titles

Terminal performance hardening and security sweep

• SAB polling moved to Web Worker with Atomics.wait
• Sharded visual SAB to prevent noisy-neighbor starvation
• MessagePort origin validation and production CSP tightening
• Hybrid input persistence across minimize/restore

Unified input bar — consistent multi-line input across every agent

• Hybrid input overlay providing consistent multi-line input
• Design token unification merging Canopy + Shadcn token systems

Worktree-scoped workspaces — isolated terminals per branch, GitHub issues integration

• Each worktree became an isolated workspace with dedicated terminals
• Create worktrees directly from GitHub issues with branch prefix selection

Design system unification, keyboard-first UX, and TUI rendering

• Replaced hardcoded colors and spacing with semantic tokens
• Comprehensive keyboard shortcuts with customizable bindings
• Atomic frame updates for WebGL, smart sticky scrolling
• WorktreeCard redesigned as high-precision workspace overview

Portal — embedded browser for web AI chats alongside terminal agents

• Context Sidecar with multi-tab Chromium browser panel
• Magic Paste for CopyTree context injection into web chats

Terminal grid with drag-and-drop dock, multi-project support, and context injection

• Pty Host pattern with dedicated UtilityProcess for PTY management
• SharedArrayBuffer ring buffer for zero-copy terminal I/O
• Configurable grid layouts with bidirectional drag-and-drop
• Process preservation during project switching
• Sleep/wake recovery with proactive PTY pause/resume

First commit — Electron, React, xterm.js, node-pty, worktrees

• Core architecture built in a 3-day sprint: IPC bridge, PtyManager, xterm.js integration
• Multi-agent coordination with lifecycle state tracking
• Terminal UX with tiling window manager aesthetic
• AI-powered semantic terminal activity detection
• Event-driven architecture with correlation IDs from day one