agent-sessions  by jazzyalex

Unified session browser and analytics for AI coding assistants

Created 5 months ago
269 stars

Top 95.6% on SourcePulse

GitHubView on GitHub
Project Summary

This native macOS application unifies session histories from various AI coding command-line interfaces, including Codex, Claude, Gemini, GitHub Copilot, Droid, and OpenClaw. It provides a local-first, privacy-focused solution for searching, browsing, and resuming past AI interactions, enabling users to quickly find and reuse prompts, code snippets, and tool outputs, thereby enhancing productivity and session management.

How It Works

Agent Sessions employs a local-only indexing strategy to manage and consolidate session data from supported AI coding CLIs. It presents a unified view of all sessions, allowing for robust filtering and cross-agent searching. The application parses and displays tool calls, outputs, and errors legibly, facilitating navigation and direct reuse of content. This local-first design prioritizes user privacy by avoiding telemetry and ensures efficient performance even with extensive session histories.

Quick Start & Requirements

  • Primary install / run command:
    • Download AgentSessions-2.11.2.dmg and drag Agent Sessions.app to Applications.
    • Alternatively, use Homebrew: brew tap jazzyalex/agent-sessions && brew install --cask agent-sessions.
  • Non-default prerequisites and dependencies: macOS 14+.
  • Estimated setup time or resource footprint: Minimal; DMG installation is drag-and-drop. Homebrew installation is standard.
  • Links: All Releases, Install, Resume Workflows, Development Overview.

Highlighted Details

  • Unified browsing and search across Codex CLI, Claude Code, Gemini CLI, GitHub Copilot CLI, Droid, OpenCode, and OpenClaw.
  • Local-only indexing ensures privacy and efficient handling of large session histories without telemetry.
  • Features include session resuming, quick snippet reuse, and advanced image workflows with inline thumbnails and a richer Image Browser.
  • Recent updates (v2.11) add OpenClaw support, enhanced image browser functionality, and significant bug fixes for indexing and power efficiency.

Maintenance & Community

Maintainers are detailed in docs/deployment.md. Contribution guidelines are available in CONTRIBUTING.md. No explicit community channels (e.g., Discord, Slack) are listed.

Licensing & Compatibility

  • License type: MIT.
  • Compatibility notes: The MIT license is permissive for commercial use and integration with closed-source projects. The application is exclusively a native macOS application.

Limitations & Caveats

The application is strictly limited to macOS 14+ and does not offer cross-platform support.

Health Check
Last Commit

1 day ago

Responsiveness

Inactive

Pull Requests (30d)
1
Issues (30d)
3
Star History
45 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.