ai-session-tracker

Unified full-text search across AI coding agent sessions (Devin, Claude Code, Cursor, Windsurf).

Features

• Unified Search: Search across all your AI coding sessions from a single command
• Fast Indexing: SQLite FTS5 full-text search for instant results
• Multiple Agents: Supports Devin CLI, Claude Code, Cursor, and Windsurf
• Deep Search: Search inside full conversation content, not just titles
• Time Filtering: Filter sessions by date with natural language ("last week", "3 days ago")
• Cross-Platform: Works on macOS, Linux, and Windows
• Auto-Setup: Automatically integrates with detected agents on first run

Installation

From PyPI (Recommended)

pip install ai-session-tracker

From Source

git clone https://github.com/itabhijitb/ai-session-tracker.git
cd ai-session-tracker
pip install -e .

Using Install Scripts

# macOS/Linux
bash install.sh

# Windows
powershell -ExecutionPolicy Bypass -File install.ps1

The install scripts will:

1. Install the package
2. Update AGENTS.md files across detected agents
3. Build the initial search index (cold start)

Usage

Basic Commands

ais search "keyword"           Search across all AI agent sessions
ais search --deep "keyword"    Deep search (full conversation content)
ais search --agent devin "key" Search only Devin sessions
ais list                       List recent sessions
ais list --agent claude-code   List only Claude Code sessions
ais status                      Show detected agents
ais index                      Rebuild the search index
ais setup                      Add ais instructions to your agents' AGENTS.md
ais preview <session-id>       Preview a session without resuming

Search Examples

# Search by keyword
ais search "pipeline debug"

# Deep search inside conversations
ais search --deep "config.yaml"

# Search specific agent
ais search --agent devin "IPS shuffle"

# Time-based filtering
ais search --since "last week" pipeline
ais search --since 2026-10-01 --before 2026-10-15 debug

# List sessions with filters
ais list --agent devin
ais list --dir ~/Projects/my-repo
ais list --since "3 days ago"

Resume Sessions

After finding a session, use the agent-specific resume command shown in the output:

• Devin: devin -r <session-id>
• Claude Code: Use /resume inside Claude Code
• Cursor: Open Cursor and use session history
• Windsurf: Open Windsurf and use session history

Supported Agents

Architecture

ai-session-tracker uses an adapter pattern where each agent has its own adapter that reads that agent's native local storage:

• Adapters: One adapter per agent (devin.py, claude_code.py, cursor.py, windsurf.py)
• Unified Index: SQLite FTS5 database aggregates sessions from all adapters
• CLI: Built with Click, rendered tables with Rich
• Auto-Index: First run automatically builds the search index from all detected agents

Development

Setup Development Environment

git clone https://github.com/itabhijitb/ai-session-tracker.git
cd ai-session-tracker
pip install -e ".[dev]"

Run Tests

pytest tests/ -v

Lint and Format

ruff check src/ tests/
ruff format src/ tests/

Build Package

python -m build

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Changelog

See CHANGELOG.md for a list of changes in each version.

Acknowledgments

• Built with Click and Rich
• Uses SQLite FTS5 for fast full-text search
• Inspired by the need to search across multiple AI coding agents