agent-sessions

Agent Sessions is a local-first macOS application that centralizes session management for multiple AI coding agents including Codex, Claude, Cursor, OpenCode, Hermes, OpenClaw, Gemini CLI, GitHub Copilot CLI, and Pi. It lets you search through all past sessions, filter by folder and repository, inspect transcripts, browse generated images, and instantly resume work from the command line. The app includes Agent Cockpit for monitoring active iTerm2 sessions in real-time, a Limits Widget for tracking Codex and Claude usage with run-out predictions, and local-only indexing designed to handle large session histories. All data stays on your Mac with no telemetry or remote uploads.

[{"step":"Install the native macOS app and authenticate with your preferred CLI tools (e.g., GitHub Copilot, Claude Code).","tip":"Ensure all CLI tools are configured with API keys in your environment variables for seamless integration."},{"step":"Use the session browser to filter past sessions by folder/repo path and date range. Example: `copilot sessions --repo acme-web-app --since 2024-05-01`.","tip":"Combine filters for precise results (e.g., `--repo data-pipeline --status completed`)."},{"step":"Check real-time rate limits before resuming sessions. Run `copilot limits --provider github` to view consumption.","tip":"Set up rate limit alerts in the app settings to avoid unexpected interruptions during critical sessions."},{"step":"Resume the most relevant session with `copilot session resume --id [SESSION_ID]`.","tip":"Use the session context to pick up where you left off without losing progress."},{"step":"Monitor session analytics to identify patterns (e.g., frequent errors, long durations) and optimize future workflows.","tip":"Export session data to CSV for deeper analysis in tools like Excel or Google Sheets."}]