chasm-cli 1.0.0

Chasm extracts and unifies chat sessions from AI coding assistants like GitHub Copilot, Cursor, and more. Never lose your AI conversations again.

✨ Features

• 🔍 Harvest - Extract chat sessions from VS Code, Cursor, Windsurf, and other editors
• 🔀 Merge - Combine sessions across workspaces and time periods
• 📊 Analyze - Get statistics on your AI assistant usage
• 🔌 API Server - REST API for building custom integrations
• 🤖 MCP Tools - Model Context Protocol support for AI agent integration
• 🗃️ Universal Database - SQLite-based storage that normalizes all providers

📦 Installation

From crates.io

cargo install chasm

From source

git clone https://github.com/nervosys/chasm.git

cd chasm

cargo install --path .

Pre-built binaries

Download from GitHub Releases:

Docker

docker pull ghcr.io/nervosys/chasm:latest

docker run -v ~/.chasm:/data ghcr.io/nervosys/chasm list workspaces

🚀 Quick Start

List discovered workspaces

chasm list workspaces

┌────────────────────────┬──────────────────┬──────────┬────────────┐
│ Name                   │ Provider         │ Sessions │ Updated    │
├────────────────────────┼──────────────────┼──────────┼────────────┤
│ my-project             │ GitHub Copilot   │ 15       │ 2026-01-08 │
│ another-project        │ Cursor           │ 8        │ 2026-01-07 │
│ open-source-contrib    │ GitHub Copilot   │ 23       │ 2026-01-06 │
└────────────────────────┴──────────────────┴──────────┴────────────┘

Show sessions for a project

chasm show path /path/to/your/project

Harvest sessions from VS Code

chasm harvest

Export a session to Markdown

chasm export session abc123 --format markdown --output chat.md

Start the API server

chasm api serve --port 8787

📖 CLI Reference

Core Commands

Data Management

Server

Options

chasm --help          # Show all commands

chasm <cmd> --help    # Show help for a specific command

chasm --version       # Show version

🔌 API Server

Start the REST API server for integration with web/mobile apps:

chasm api serve --host 0.0.0.0 --port 8787

Endpoints

Example

curl http://localhost:8787/api/stats

{
  "success": true,
  "data": {
    "totalSessions": 330,
    "totalMessages": 19068,
    "totalWorkspaces": 138,
    "totalToolInvocations": 122712
  }
}

🤖 MCP Integration

Chasm provides Model Context Protocol tools for AI agent integration:

chasm mcp serve

Available Tools

• chasm_list_workspaces - List all workspaces
• chasm_list_sessions - List sessions in a workspace
• chasm_get_session - Get full session content
• chasm_search_sessions - Search across all sessions
• chasm_get_stats - Get database statistics

🗃️ Supported Providers

Editor-based

• ✅ GitHub Copilot (VS Code)
• ✅ Cursor
• ✅ Windsurf
• ✅ Continue.dev

Local LLMs

• ✅ Ollama
• ✅ LM Studio
• ✅ GPT4All
• ✅ LocalAI
• ✅ llama.cpp / llamafile

Cloud APIs

• ✅ OpenAI / ChatGPT
• ✅ Anthropic / Claude
• ✅ Google / Gemini
• ✅ Perplexity

📁 Database

Chasm stores all data in a local SQLite database:

Schema

Workspaces ──< Sessions ──< Messages
                  │
                  ├──< Checkpoints
                  └──< ShareLinks

🛠️ Development

Prerequisites

• Rust 1.75+
• Git

Building

git clone https://github.com/nervosys/chasm.git

cd chasm

cargo build --release

Running tests

cargo test

Running the TUI

cargo run -- tui

📜 License

Licensed under either of:

• Apache License, Version 2.0 (LICENSE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE or http://opensource.org/licenses/MIT)

at your option.

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide and Code of Conduct.

🔒 Security

For security issues, please see our Security Policy.

📞 Support

• 📖 Documentation
• 💬 GitHub Discussions
• 🐛 Issue Tracker