AI Session Manager

中文文档

AI coding assistant session manager with browser extension - supports Kilo Code, OpenCode, and TabBitBrowser with search, export, and batch extraction.

Features

• Centralized Management — View all sessions from Kilo Code and OpenCode in one place
• Session Search — Full-text search across session content with keyword highlighting
• Message Viewing — Browse complete conversation history with expandable sections
• Project Statistics — Analytics on session count, message volume, and popular projects
• Data Export — Export sessions as Markdown or JSON for documentation and archiving
• Multi-Source Support — Switch between Kilo Code and OpenCode data sources
• Browser Tab Export — Extract and save chat content from TabBitBrowser via browser extension
• Batch Export to Directory — Export all tab contents or sessions to a specified directory (default: G:\knowledge\source\browser-export, configurable in UI)

Screenshots

Note: Screenshots will be added after the first release.

Session List	Session Detail
Screenshot placeholder	Screenshot placeholder

Quick Start

Option 1: Docker (Recommended)

# Clone the repository
git clone https://github.com/zccyman/ai-session-manager.git
cd ai-session-manager

# Start services
./start.sh docker

# Stop services
./start.sh stop

Access http://localhost:3000

Option 2: Local Development

Backend:

cd ai-session-manager/backend
pip install -r requirements.txt
./start.sh backend

Frontend:

cd ai-session-manager/frontend
npm install
npm run dev

Configuration

Backend environment variables (see ai-session-manager/backend/.env.example):

• DATABASE_URL: SQLite database path
• OPENCODE_DB_PATH: OpenCode database path

API Documentation

After starting the backend, visit: http://localhost:8000/docs

Project Structure

ai-session-manager/
├── .kilocode/                          # Kilo configuration
│   ├── skills/
│   │   └── dev-workflow/
│   │       └── SKILL.md                # Dev workflow skill
│   └── workflows/
├── ai-session-manager/                 # Main application code
│   ├── backend/                        # FastAPI backend
│   │   ├── app/
│   │   │   ├── routes/                 # API routes
│   │   │   ├── services/               # Business logic
│   │   │   ├── models.py               # Data models
│   │   │   ├── database.py             # Database connection
│   │   │   └── main.py                 # FastAPI app
│   │   └── requirements.txt
│   ├── frontend/                       # React frontend
│   │   ├── src/
│   │   │   ├── components/             # UI components
│   │   │   ├── hooks/                  # React hooks
│   │   │   ├── services/               # API client
│   │   │   └── types/                  # TypeScript types
│   │   └── package.json
│   └── extension/                      # Browser extension
│       ├── manifest.json               # Extension manifest
│       ├── popup.html                  # Extension popup UI
│       ├── popup.js                    # Popup logic
│       ├── content.js                  # Content script
│       └── styles.css                  # Extension styles
├── openspec/                           # OpenSpec specifications
│   ├── changes/                        # Change proposals
│   └── specs/                          # Project specifications
├── docker-compose.yml
├── start.sh                            # Startup scripts
└── README.md

Browser Extension

The browser extension allows you to extract chat content from TabBitBrowser and send it to AI Session Manager.

Installation

1. Open Chrome and navigate to chrome://extensions/
2. Enable "Developer mode" in the top right
3. Click "Load unpacked"
4. Select the ai-session-manager/extension folder

Usage

1. Navigate to a TabBitBrowser chat page (https://web.tabbitbrowser.com/chat/*)
2. Click the extension icon in the toolbar
3. Choose one of the following options:
   • Extract Current Tab — Extract chat from the current tab
   • Extract All Tabs — Extract chats from all open TabBitBrowser tabs
4. Click Send to AI Session Manager or Send All to save the content

Features

• Single Tab Extraction — Extract conversation from current tab
• Batch Extraction — Extract from all TabBitBrowser tabs at once
• Copy to Clipboard — Copy markdown content directly
• Download as File — Save as .md file
• API Configuration — Configure the API endpoint in the extension popup
• Batch Export to Directory — Export all tab contents as Markdown files to a configurable directory

Tech Stack

Component	Technology
Backend	FastAPI + SQLite
Frontend	React + TypeScript + Vite + TailwindCSS
Search	SQLite FTS5
Deployment	Docker + Docker Compose

Development

Local Development Setup

# Clone the repository
git clone https://github.com/zccyman/ai-session-manager.git
cd ai-session-manager

# Start backend
cd ai-session-manager/backend
pip install -r requirements.txt
uvicorn app.main:app --reload

# Start frontend (in another terminal)
cd ai-session-manager/frontend
npm install
npm run dev

Debugging

• Backend API docs: http://localhost:8000/docs
• Frontend dev server: http://localhost:5173
• Backend logs: Check terminal running uvicorn
• Frontend logs: Check browser DevTools console

License

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

Acknowledgments

• Built for managing Kilo Code and OpenCode session data
• Inspired by the need to extract and archive AI coding knowledge