session-md

A terminal UI for browsing and managing AI chat sessions from multiple sources - Claude Code, Claude.ai exports, OpenCode, and Memorizer.

Built with Bun, OpenTUI, and TypeScript.

Features

• Browse sessions from 4 sources in a single TUI
• Filter sessions by source and text search
• Full-text content search (g) with SQLite FTS5 index
• Multi-select sessions and copy as Markdown to target folders
• Markdown preview with syntax highlighting
• Configurable targets for organizing exported sessions
• Incremental search index - only new/changed sessions are re-indexed on startup

Supported Sources

Source	Format	Location
Claude Code	JSONL	~/.claude/projects/**/*.jsonl
Claude.ai Export	ZIP / conversations.json	Configurable path
OpenCode	JSON shards	~/.local/share/opencode/storage/
Memorizer	REST API	Configurable URL

Install

Global (recommended)

bun install -g @alexzeitler/session-md
session-md

From source

git clone https://github.com/AlexZeitler/session-md.git
cd session-md
bun install
bun src/index.ts

Update

session-md update

Version

session-md --version

Configuration

Config file: ~/.config/session-md/config.toml

A default config is created on first run.

default_target = "~/notes/claude-chats"

[targets]
vault   = "~/notes/claude-chats"
work    = "~/work/claude-sessions"
archive = "~/archive/claude"

[sources]
claude_code    = "~/.claude/projects"
opencode       = "~/.local/share/opencode/storage"
# claude_export = "~/Downloads/conversations.zip"
# memorizer_url = "http://localhost:5001"

Keyboard Shortcuts

Navigation

Key	Action
Tab	Cycle focus: Sources → Sessions → Detail
Shift+Tab	Cycle focus backward
j / k	Navigate list / scroll detail
gg	Jump to top (list or detail)
G	Jump to bottom (list or detail)
Ctrl+d / Ctrl+u	Page down / up in detail
Esc	Back to sessions from detail

Sessions

Key	Action
Space	Toggle selection
/	Open text filter
g	Full-text content search (grep)
c	Copy selected sessions to target
q	Quit

Filter (/)

Key	Action
Type	Filter sessions by title/project
Enter	Move to filtered results (filter stays active)
/	Return to filter input
Esc	Close filter

Content Search (g)

Key	Action
Type	Search within session content (FTS5)
Enter	Move to results / open selected result
/	Return to search input
Esc	Close search

Content search uses a SQLite FTS5 index stored at ~/.config/session-md/search-index.sqlite. The index is built incrementally on startup - only new or changed sessions are indexed.

To rebuild the index from scratch:

session-md reindex

MCP Server

session-md can run as an MCP server, exposing session search and retrieval to AI assistants like Claude Code.

Stdio Transport

For direct integration with Claude Code:

session-md mcp

Add to your Claude Code MCP config:

{
  "mcpServers": {
    "session-md": {
      "command": "session-md",
      "args": ["mcp"]
    }
  }
}

HTTP Transport

Foreground:

session-md mcp --http              # default port 8282
session-md mcp --http --port 9000  # custom port

Daemon (background):

session-md mcp --http --daemon
session-md mcp stop

Daemon logs: ~/.cache/session-md/mcp.log

Health check: GET http://localhost:8282/health

MCP Tools

Tool	Description
search_sessions	Full-text search across all indexed sessions
list_sessions	List sessions, optionally filtered by source
get_session	Retrieve full Markdown content of a session by ID
import_sessions	Re-scan all configured sources and update the index

Requirements

• Bun >= 1.0

License

MIT