Skip to content

gitmeBT/SessionManager

Repository files navigation

SessionManager Icon

SessionManager

A macOS desktop app that unifies session management for AI coding agents — find, browse, and resume sessions from OpenCode, Claude Code, and Codex in one place.

Features

  • Unified session index — automatically scans and indexes sessions from multiple AI agents into a single SQLite database
  • Fast search — find any session by title, project, or content in seconds
  • Built-in terminal — resume a session with one click and continue working directly in the app
  • Pin & archive — pin important sessions, archive completed ones
  • Dark & light themes — matches your system appearance
  • Bilingual UI — English and Chinese (可在设置中切换语言)

Supported Agents

Agent Data Source
OpenCode SQLite (~/.local/share/opencode/opencode.db)
Claude Code JSONL (~/.claude/projects/)
Codex SQLite (~/.codex/state_5.sqlite)

Screenshots

TODO: Add screenshots

Installation

Download the latest DMG from Releases.

  • Apple Silicon (M1/M2/M3/M4) → download the arm64 version
  • Intel Mac → download the x64 version

On first launch, right-click the app → Open to bypass Gatekeeper (the app is unsigned).

Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build locally
npm run pack

# Package DMG
npm run dist

Tech Stack

License

Apache-2.0