🚀 LLM Session Manager

Monitor, Collaborate, and Optimize Your AI Coding Sessions

The first comprehensive monitoring and collaboration platform for Claude Code, Cursor, and GitHub Copilot

Quick Start • Features • User Guide • FAQ • Demo

🎯 The Problem

You're using AI coding assistants like Claude Code or Cursor, but:

💸 No visibility into token usage until you hit limits
⚠️ No warnings when sessions are getting unstable
🤷 Can't collaborate with teammates on AI sessions
🔁 Repeat mistakes - no way to learn from past sessions
📊 No insights - just hoping the AI works well

✨ The Solution

LLM Session Manager gives you complete control over your AI coding workflow:

📊 Real-time monitoring - Track every token, error, and metric
🎯 Smart health scores - Know when to start fresh
👥 Team collaboration - Share sessions, chat, and learn together
🧠 AI-powered insights - Learn from patterns across all sessions
🔌 Zero configuration - Auto-detects all your AI tools

Comprehensive testing • 28/29 tests passing (96.6%) • Production ready

🚀 Quick Start (30 seconds)

Choose your installation method:

⚡ One Command Install

curl -fsSL https://raw.githubusercontent.com/\
iamgagan/llm-session-manager/main/\
setup.sh | bash

Then: poetry run python -m llm_session_manager.cli list

🐳 Docker Compose

docker-compose up -d
open http://localhost:3000

Zero configuration required!

☁️ GitHub Codespaces

Everything pre-installed!

📚 Detailed Guide

→ See Full Install Guide

Multiple methods, detailed steps, troubleshooting

🎬 See It In Action

📊 Session Discovery & Monitoring

Discover All Your AI Sessions Auto-discovers Claude Code, Cursor, and GitHub Copilot	Detailed Session Information Complete metrics with health scoring and token tracking
Multi-Factor Health Analysis Smart health scoring with actionable recommendations	Real-Time Monitoring Dashboard Track all sessions in real-time with live updates

🏷️ Organization & Search

Tagging System Tag sessions with multiple labels for easy filtering

Project Management Organize sessions by project with descriptions

📤 Export & Reports

Markdown Reports Beautiful markdown reports for documentation

AI-Powered Recommendations Intelligent insights based on session patterns

🧠 Memory & Intelligence

Cross-Session Memory Search and learn from past sessions with AI

Team Collaboration API Real-time collaboration with REST API & WebSockets

🌟 Why LLM Session Manager?

For Individual Developers

Stop guessing when to start a new session

$ llm-session health claude_code_65260

Session Health: 67% (CAUTION)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚠️  Token usage: 82% (16,400 / 20,000)
⚠️  Error rate increasing (15 errors)
💡 Recommendation: Consider starting fresh

Based on 50 similar sessions:
  • Average failure point: 85% tokens
  • Success rate drops 40% after 80%

For Teams

Collaborate on AI sessions in real-time

$ llm-session share claude_code_65260

✅ Session Sharing Active!
🔗 http://localhost:3000/session/claude_code_65260

Your team can now:
  ✓ View live metrics and token usage
  ✓ Chat and discuss the session
  ✓ See your cursor position in real-time
  ✓ Add comments at specific code locations

For Engineering Managers

Understand team productivity and AI usage

Track total token spend across team
Identify patterns in successful vs failed sessions
Build team knowledge base from AI interactions
Monitor health trends and optimize workflows

⚡ Installation (Choose Your Method)

Option 1: One-Command Install (Recommended)

curl -fsSL https://raw.githubusercontent.com/iamgagan/llm-session-manager/main/setup.sh | bash

Then start using:

poetry run python -m llm_session_manager.cli list

Option 2: Manual Install

git clone https://github.com/iamgagan/llm-session-manager.git
cd llm-session-manager
poetry install

# If upgrading from an older version, run database migration
python3 migrate_database.py

# Optional: Enable AI insights
export LLM_API_KEY="your-openai-or-anthropic-key"

# Start using
poetry run python -m llm_session_manager.cli list

Option 3: Docker Compose (Full Stack)

docker-compose up -d
open http://localhost:3000

Option 4: GitHub Codespaces (Instant)

Everything pre-configured and ready to use!

→ See Detailed Installation Guide

🎯 Core Features

🔍 Session Monitoring ✅ Auto-discover all AI coding sessions ✅ Real-time token tracking ✅ Multi-factor health scoring ✅ Live TUI dashboard ✅ Export to JSON/YAML/Markdown	👥 Team Collaboration ✅ Multi-user session sharing ✅ Real-time chat ✅ Live cursor tracking ✅ Code annotations ✅ WebSocket-powered sync
🧠 AI Intelligence ✅ Pattern recognition (Cognee) ✅ Smart recommendations ✅ Session autopsy analysis ✅ Team knowledge building ✅ Predictive insights	🔌 Integrations ✅ Claude Code, Cursor, Copilot ✅ Model Context Protocol (MCP) ✅ ChromaDB semantic search ✅ REST API + WebSockets ✅ VS Code extension (built, ready for publishing)

📋 Quick Command Reference

# Session Management
poetry run python -m llm_session_manager.cli list                    # List all active sessions
poetry run python -m llm_session_manager.cli monitor                 # Real-time TUI dashboard
poetry run python -m llm_session_manager.cli health <session-id>     # Detailed health breakdown
poetry run python -m llm_session_manager.cli export <session-id> --format json  # Export session data

# AI-Powered Insights 🧠
poetry run python -m llm_session_manager.cli recommend               # Get smart recommendations
poetry run python -m llm_session_manager.cli memory-search "authentication"  # Search team knowledge

# Team Collaboration 👥
poetry run python -m llm_session_manager.cli share <session-id>      # Share with team

# Organization & Search
poetry run python -m llm_session_manager.cli tag <session-id> feature auth  # Tag sessions

# MCP Integration (Claude Desktop)
poetry run python -m llm_session_manager.cli mcp-config              # Generate config

→ See Full CLI Documentation

📚 Documentation

📖 Getting Started

Quick Start Guide - Get running in 30 seconds
Installation Options - Detailed setup for all methods
First Session Tutorial - Your first monitored session

🔧 Feature Guides

AI Insights with Cognee - Unlock intelligent recommendations
Team Collaboration - Share and collaborate on sessions
MCP Integration - Use with Claude Desktop
Architecture Overview - How it all works

📋 Reference

CLI Command Reference - All available commands
API Documentation - REST API endpoints
Changelog - Version history and updates

🏗️ Technical Architecture

┌──────────────────────────────────────────────────────────────┐
│                    LLM Session Manager                       │
├──────────────────────────────────────────────────────────────┤
│                                                              │
│  ┌─────────────────┐  ┌─────────────────┐  ┌─────────────┐ │
│  │   CLI Monitor   │  │  Web Dashboard  │  │ AI Engine   │ │
│  │                 │  │                 │  │  (Cognee)   │ │
│  │  • Discovery    │  │  • Real-time UI │  │             │ │
│  │  • Tracking     │  │  • Team Chat    │  │  • Learn    │ │
│  │  • Health       │  │  • Presence     │  │  • Analyze  │ │
│  │  • Export       │  │  • Cursors      │  │  • Suggest  │ │
│  └────────┬────────┘  └────────┬────────┘  └──────┬──────┘ │
│           │                    │                   │        │
│           └────────────┬───────┴───────────────────┘        │
│                        ▼                                    │
│           ┌────────────────────────────┐                    │
│           │   FastAPI Backend          │                    │
│           │   • REST API               │                    │
│           │   • WebSocket Server       │                    │
│           │   • Session Management     │                    │
│           └────────────┬───────────────┘                    │
│                        ▼                                    │
│           ┌────────────────────────────┐                    │
│           │   Data Layer               │                    │
│           │   • SQLite (Sessions)      │                    │
│           │   • ChromaDB (Memories)    │                    │
│           │   • Cognee (Knowledge)     │                    │
│           └────────────────────────────┘                    │
│                                                              │
└──────────────────────────────────────────────────────────────┘

Supported AI Tools: Claude Code • Cursor • GitHub Copilot

Tech Stack:

Backend: Python 3.10+, FastAPI, SQLAlchemy, WebSockets
Frontend: React 18, Vite, TailwindCSS
AI Layer: Cognee, LanceDB, ChromaDB, OpenAI/Anthropic APIs
CLI: Typer, Rich (beautiful terminal UI)
Testing: Comprehensive test suite, 96.6% pass rate (28/29 tests)

🧪 Testing & Development

Running Tests

We have a comprehensive automated test suite with 28/29 tests passing (96.6% pass rate).

Quick test:

# Clone and install
git clone https://github.com/iamgagan/llm-session-manager.git
cd llm-session-manager
poetry install

# Run comprehensive test suites
python3 test_all_features.py        # CLI features (19/19 ✅)
python3 test_backend_features.py    # Backend API (7/7 ✅)
python3 test_mcp_features.py        # MCP integration (2/3 ✅)

# View detailed results
cat COMPREHENSIVE_TEST_REPORT.md

What gets tested:

✅ CLI commands (19 tests) - list, show, health, export, memory, tagging
✅ Backend API (7 tests) - REST endpoints, session stats, projects, insights
✅ MCP Integration (3 tests) - Config generation, server startup, tools
✅ Export functionality (all formats: JSON, YAML, Markdown)
✅ Memory system (add, search, list, stats)
✅ Team collaboration features
✅ AI-powered recommendations

Manual Testing

1. Test CLI monitoring:

# List your active AI sessions
poetry run python -m llm_session_manager.cli list

# Monitor in real-time (dashboard view)
poetry run python -m llm_session_manager.cli monitor
# Press Ctrl+C to exit the monitor

# Get detailed health breakdown for a specific session
poetry run python -m llm_session_manager.cli health <session-id>

# Example with actual session ID:
poetry run python -m llm_session_manager.cli health claude_code_60420

Note: The monitor command shows a live-updating dashboard. To exit, press Ctrl+C. If keyboard shortcuts aren't working, use Ctrl+C to quit.

2. Test collaboration features:

# Terminal 1: Start backend
cd backend
uvicorn app.main:app --reload

# Terminal 2: Start frontend
cd frontend
npm install
npm run dev

# Browser: Open http://localhost:3000
# Create a session, invite teammates, test chat

3. Test export:

# Export session data
poetry run python -m llm_session_manager.cli export <session-id> --format json

# Verify file created
cat /tmp/export.json

Contributing

Want to contribute? Here's how to get started:

Fork and clone the repository
Install dependencies: poetry install
Run tests: python3 test_all_features.py && python3 test_backend_features.py
Make changes and add tests
Ensure all tests pass (28/29 passing)
Submit a pull request

Areas we'd love help with:

Additional AI tool integrations (Windsurf, Aider, etc.)
Enhanced pattern recognition algorithms
UI/UX improvements
Documentation and tutorials
Bug fixes and optimizations

See CONTRIBUTING.md for detailed guidelines.

🗺️ Roadmap

✅ v0.3.0 (Current)

✅ Real-time collaboration
✅ Cognee AI integration
✅ Team chat & presence
✅ Session sharing
✅ AI-powered insights
✅ MCP support
✅ VS Code extension (built)
✅ 96.6% test coverage (28/29 tests)

🔨 v0.4.0 (Next - Q1 2026)

🔨 VS Code extension (marketplace)
🔨 Automated session optimization
🔨 Predictive health scoring
🔨 Team analytics dashboard
🔨 Custom AI learning rules
🔨 Session templates

🔮 v0.5.0 (Future)

💡 Session recording/replay
💡 Mobile monitoring app
💡 Enterprise SSO/SAML
💡 Advanced git integration
💡 Cost optimization tools
💡 Custom AI model support

→ Vote on Features

🎯 Use Cases

💼 For Startups

Key Benefits:

💰 Reduce AI costs by tracking token usage across all sessions
📊 Get visibility into team AI usage patterns
🚀 Debug faster with complete session history
⚠️ Identify abandoned or inefficient sessions
📈 Optimize AI budget allocation

👨‍💻 For Individual Developers

Key Benefits:

⏱️ Stop guessing when to restart sessions
🎯 Get AI-powered recommendations based on your patterns
📚 Build a personal knowledge base from all AI interactions
🔍 Search across all past sessions semantically
📊 Track your token usage and coding patterns

🏢 For Engineering Teams

Key Benefits:

👥 Collaborate on AI sessions in real-time
📈 Track team-wide AI productivity metrics
🧠 Build organizational knowledge from AI interactions
💬 Share insights and best practices
🎯 Learn from collective session patterns
📊 Monitor team health and token usage

🤝 Contributing

We'd love your help making LLM Session Manager better! Here's how to contribute:

🎯 High-Impact Areas

🔍 Detection & Monitoring

Support for more AI coding tools
Better token counting algorithms
Enhanced health metrics

🧠 AI & Intelligence

Improved pattern recognition
Custom learning models
Better recommendations

🎨 UI/UX

React component improvements
Dark mode enhancements
Mobile-responsive design

📚 Documentation

Tutorials and guides
Video walkthroughs
Translation to other languages

→ See Contributing Guide | → Good First Issues

⭐ Star History

If you find LLM Session Manager useful, please consider giving it a star! It helps others discover the project.

🙏 Acknowledgments

Built with these amazing open-source projects:

FastAPI - High-performance web framework
React + Vite - Modern frontend
Cognee - AI knowledge graphs
SQLAlchemy - Powerful ORM
Rich - Beautiful terminal output
Typer - CLI framework

📄 License

MIT License - see LICENSE for details.

TL;DR: Free for personal and commercial use. Do whatever you want with it!

💬 Community & Support

🚀 Ready to Launch?

Get started in 30 seconds:

git clone https://github.com/iamgagan/llm-session-manager.git
cd llm-session-manager
poetry install
poetry run python -m llm_session_manager.cli list

Or explore the features:

# List all your AI sessions
poetry run python -m llm_session_manager.cli list

# Get health check on a session
poetry run python -m llm_session_manager.cli health <session-id>

# Real-time monitoring dashboard
poetry run python -m llm_session_manager.cli monitor

Built with ❤️ for AI-Powered Development Teams

Monitor smarter • Collaborate better • Learn continuously

⭐ Star on GitHub • 📖 Read the Docs • 🚀 Try the Demo

Helping developers and teams get the most out of AI coding assistants since 2024

Name		Name	Last commit message	Last commit date
Latest commit History 29 Commits
.devcontainer		.devcontainer
.github/workflows		.github/workflows
backend		backend
data/memories/adbb6bd0-adb4-4ac5-82a1-256339e63251		data/memories/adbb6bd0-adb4-4ac5-82a1-256339e63251
docs		docs
frontend		frontend
llm_session_manager		llm_session_manager
manual_tests		manual_tests
screenshots		screenshots
tests		tests
.gitignore		.gitignore
.md_files_classification.txt		.md_files_classification.txt
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
FINAL_IMPLEMENTATION_REPORT.md		FINAL_IMPLEMENTATION_REPORT.md
LICENSE		LICENSE
QUICKSTART.md		QUICKSTART.md
README.md		README.md
USER_GUIDE.md		USER_GUIDE.md
docker-compose.yml		docker-compose.yml
install.html		install.html
migrate_database.py		migrate_database.py
push_to_github.sh		push_to_github.sh
pyproject.toml		pyproject.toml
run_all_tests.sh		run_all_tests.sh
setup.sh		setup.sh
setup_vscode_extension.sh		setup_vscode_extension.sh
test_all_features.py		test_all_features.py
test_backend_features.py		test_backend_features.py
test_mcp_features.py		test_mcp_features.py
test_results_backend.json		test_results_backend.json
test_results_comprehensive.json		test_results_comprehensive.json
test_results_mcp.json		test_results_mcp.json

License

iamgagan/llm-session-manager

Folders and files

Latest commit

History

Repository files navigation

🚀 LLM Session Manager

Monitor, Collaborate, and Optimize Your AI Coding Sessions

🎯 The Problem

✨ The Solution

🚀 Quick Start (30 seconds)

⚡ One Command Install

🐳 Docker Compose

☁️ GitHub Codespaces

📚 Detailed Guide

🎬 See It In Action

📊 Session Discovery & Monitoring

🏷️ Organization & Search

📤 Export & Reports

🧠 Memory & Intelligence

🌟 Why LLM Session Manager?

For Individual Developers

For Teams

For Engineering Managers

⚡ Installation (Choose Your Method)

Option 1: One-Command Install (Recommended)

Option 2: Manual Install

Option 3: Docker Compose (Full Stack)

Option 4: GitHub Codespaces (Instant)

🎯 Core Features

🔍 Session Monitoring

👥 Team Collaboration

🧠 AI Intelligence

🔌 Integrations

📋 Quick Command Reference

📚 Documentation

📖 Getting Started

🔧 Feature Guides

📋 Reference

🏗️ Technical Architecture

🧪 Testing & Development

Running Tests

Manual Testing

Contributing

🗺️ Roadmap

✅ v0.3.0 (Current)

🔨 v0.4.0 (Next - Q1 2026)

🔮 v0.5.0 (Future)

🎯 Use Cases

💼 For Startups

👨‍💻 For Individual Developers

🏢 For Engineering Teams

🤝 Contributing

🎯 High-Impact Areas

⭐ Star History

🙏 Acknowledgments

📄 License

💬 Community & Support

💡 Questions

🐛 Bug Reports

📖 Documentation

📝 Changelog

🚀 Ready to Launch?

Built with ❤️ for AI-Powered Development Teams

About

Topics

Resources

License

Contributing

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Contributors 2

Languages

Packages