Pi Session Manager

Changelog

Release history and notable changes for Pi Session Manager.

For the full changelog, see CHANGELOG.md on GitHub.

Unreleased

Windows Compatibility & Cross-Platform Scripts

  • Strengthened Windows support across frontend and backend:
    • Path separator handling now consistently supports both / and \ (session tree labels, dashboard/kanban project views, search plugins)
    • Project/path matching now aligns with Windows case-insensitive behavior where needed
    • Shell discovery now supports PATH/PATHEXT candidates (powershell.exe, pwsh.exe, cmd.exe, bash.exe)
    • Export command resolution supports cross-platform pi / pi.cmd / pi.exe lookup
  • Migrated repository scripts away from Bash:
    • All former .sh scripts replaced by .mjs equivalents
    • Added shared script helper scripts/script-utils.mjs
    • Website postbuild script migrated to website/scripts/postbuild.mjs
    • build:cli remains a Node-based cross-platform entry (scripts/build-cli.mjs)

Update Checker

  • Added GitHub Releases-based update detection flow
  • Default behavior: auto-check once per day (non-intrusive)
  • Added Settings → Updates with manual Check Now
  • Added dismissible bottom-right update toast
  • Added release-notes modal with Markdown rendering

Version Source Accuracy

  • App version used for update comparison now comes from build-time injected __APP_VERSION__
  • Build resolves version from CI/tag context and git tag --points-at HEAD first, with package version fallback
  • This avoids mismatches between source package.json and actual release tags

Session Viewer Scroll Performance & Stability

  • Moved virtual-scroll state updates into the message panel to avoid parent-level re-renders during scroll
  • Kept toolbar scroll actions with a ref bridge (scrollToTop / scrollToBottom) after refactor
  • Tuned message virtualizer overscan from 12 to 8 and memoized key viewer components
  • Improved dynamic measurement and bottom-edge load-more behavior for smoother long-session scrolling
  • Fixed a cached-height gap double-count issue and reverted an over-aggressive scroll-time measurement skip that could cause text overlap

Subagent Session Viewer

  • View full subagent conversations inline with clickable cards showing agent name, model, duration, tokens
  • Modal with scale+fade animation renders complete subagent JSONL sessions
  • Supports single, parallel, chain, and management action modes
  • Nested subagent support — stacked modals with incremental z-index
  • Thinking/Tools toggle buttons (Cmd/Ctrl + T / Cmd/Ctrl + O) in both main and subagent toolbars

Pi Config Settings Panel

  • Resources tab: scan and manage extensions, skills, prompts, themes with scope grouping
  • Settings tab: full alignment with Pi source — 25+ settings across 5 groups
  • Version History as standalone tab with preview/restore UI
  • Progressive model loading with provider/model dropdowns

Unified SearchFilterBar

  • Reusable search + tag filter bar shared across list, project, and Kanban views
  • Desktop sidebar: always visible; mobile: compact layout with toggles

i18n Cleanup

  • Fixed ~50 hardcoded Chinese/English strings across 19 component files
  • Added missing translation keys for settings, dashboard, viewer, subagent, and terminal

Single-Port Architecture (CLI)

  • API, WebSocket (/ws), and embedded frontend all served on port 52131
  • One tunnel/proxy sufficient for remote access

Remote Access

  • Auth gate for non-localhost access with API token management
  • Remote config via URL params (?server=, ?token=, ?transport=)
  • SSE transport for mobile-friendly real-time updates

Mobile Adaptation

  • Full responsive support for screens < 768px
  • Bottom navigation bar with 5 tabs
  • Long-press context menu, snap-scroll Kanban, safe-area insets

Other Highlights

  • Connection status banner (disconnect/reconnect indicators)
  • Incremental session scanning with diff-based frontend updates
  • HTTP transport + SSE as WebSocket alternative
  • Configurable bind address for network exposure control
  • Session content LRU cache for faster back-navigation
  • Terminal resume command (Cmd/Ctrl + R)
  • Flow view with React Flow graph visualization
  • Multi-path session directories
  • Hierarchical tags with parent-child relationships
  • Kanban UX improvements (project filtering, context menu, untagged column)

v0.1.0 — 2026-01-30

The initial release with core functionality:

Session Management

  • Session list scanning from ~/.pi/agent/sessions/
  • Session viewer with Pi HTML template
  • Delete, export (HTML/Markdown/JSON), and rename sessions

Search & Analytics

  • Full-text search across user and AI messages
  • Statistics dashboard (total sessions, messages, top projects)
  • Search result match count badges

UX

  • Keyboard shortcuts (Cmd/Ctrl + R, Cmd/Ctrl + F, Cmd/Ctrl + Shift + S, Esc)
  • Dark mode UI
  • Virtual scrolling for large session lists

Technical Foundation

  • Tauri 2 + Rust backend with SQLite and Tantivy
  • React 18 + TypeScript + Vite frontend
  • Export, stats, and search modules

Pi Session Manager follows Conventional Commits and Semantic Versioning.

On this page