thimiko

thimiko is θυμικό.

It makes your local AI coding chats searchable. It reads Codex, Claude Code, GitHub Copilot, and Gemini CLI history, builds a local SQLite index, and lets you search it from the terminal or through MCP.

Your original chat files are left alone.

Why

Useful things get buried in old chats: fixes, decisions, failed approaches, commands, and the one detail you need six weeks later.

With thimiko, you can ask things like:

• "Have I leaked a secret that starts with 0xSecret in our chats?"
• "Did we talk about X last week?"
• "Can you collect everything from our chats about Y and make me a study plan?"
• "Why did we decide not to use Redis for the job queue?"
• "Find the chat where we fixed the flaky migration test."
• "What command did we use to recover the broken production index?"
• "Have I pasted any customer names, internal URLs, or production hostnames?"
• "Show me previous attempts at this error, including the surrounding messages."

It is especially handy for secret audits, incident reconstruction, architecture decision archaeology, compliance checks, recurring bugs, and picking up an old project without starting from zero.

Install

uv tool install "thimiko[mcp]"

For local development:

uv tool install -e ".[mcp]"

Use it

Run thimiko by itself to see the available commands.

Build the index once:

thimiko build

Then keep it fresh and search it:

thimiko update
thimiko search "database migration"
thimiko search "permission denied" --source codex --limit 5
thimiko search "rate limit" --days 10 --text

By default, thimiko reads:

• Codex: ~/.codex/sessions/**/*.jsonl
• Claude Code: ~/.claude/projects/**/*.jsonl
• GitHub Copilot: VS Code's workspaceStorage/*/chatSessions/
• Gemini CLI: ~/.gemini/tmp/*/chats/

You can also pass a file or directory directly to build or update.

MCP

Run the read-only MCP server with:

thimiko mcp

It exposes three tools: search_chats, get_turn, and get_session. Point your MCP client at thimiko mcp, then your assistant can search old chats and open the relevant surrounding conversation.

The index stays local. Its default location is %LOCALAPPDATA%\thimiko\thimiko.sqlite on Windows.

For implementation details and instructions for adding another chat source, see ARCHITECTURE.md.