llm-convos

A plugin for LLM that lets you browse, search, and resume past conversations interactively.

Installation

llm install llm-convos

Usage

llm convos

This opens an interactive list of your recent conversations. Use ↑/↓ to navigate, and q or Esc to quit.

From the picker you can:

• Press Enter to resume the selected conversation
• Press s to show the full conversation rendered as markdown in your terminal
• Press w to write the conversation to a markdown file (prompts for a filename, pre-filled with the conversation ID)

Pass -c N/--context N to print the last N exchanges before resuming, so you have context for where you left off.

Show a conversation directly

llm convos show <conversation-id>

Renders the full conversation as markdown in your terminal. Pass -o/--output to write to a file instead:

llm convos show <conversation-id> -o transcript.md

Modes

Plain mode is used automatically when stdout is not a tty.

Searching

llm convos -s asyncio

Filters conversations to those containing the search term in any prompt or response. In interactive mode the matching excerpt is shown (with the term highlighted) instead of the first prompt.

Options

llm convos:

-n, --limit INTEGER      Max conversations to show (-1 for all) [default: 20]
-s, --search TEXT        Filter by prompt/response text
-m, --mode [interactive|preview|plain]
                         Display mode
-d, --database FILE      Path to log database (default: llm's logs.db)
-c, --context INTEGER    Exchanges to print before resuming [default: 0]

llm convos show <conversation-id>:

-o, --output FILE        Write markdown to this file instead of printing
-d, --database FILE      Path to log database (default: llm's logs.db)

Keyboard shortcuts

Custom database path

If you keep your LLM logs at a non-default path, pass it explicitly:

llm convos -d /path/to/logs.db

The LLM_USER_PATH environment variable is also respected automatically.

Development

git clone https://github.com/daturkel/llm-convos
cd llm-convos
uv run pytest

To run LLM with your in-development version of the plugin:

uv run llm convos