thoughtline

Documentation

Overview

Package main is the entry point for the Thoughtline MCP server.

Thoughtline speaks the Model Context Protocol over stdio. An MCP-compatible client (Claude Code, Cursor, Zed, ...) launches this binary and exchanges JSON-RPC messages over stdin/stdout. All tool implementations live in internal/server; storage in internal/storage.

Configuration (env vars):

THOUGHTLINE_HOME   Directory for the SQLite database. Defaults to the
                   platform user-data dir (see ADR 0003):
                     - Linux:   $XDG_DATA_HOME or ~/.local/share, then /thoughtline
                     - macOS:   ~/Library/Application Support/thoughtline
                     - Windows: %LOCALAPPDATA%\thoughtline
                   On first launch after upgrading from a build that used
                   the cache dir, the DB is auto-migrated.
THOUGHTLINE_DB     Override the database file path entirely. Wins over
                   THOUGHTLINE_HOME if set. Useful for tests.
THOUGHTLINE_PROJECT  Override the default project identifier. Defaults to
                   the basename of the working directory at startup.