llm-convos 0.1.0

Easily browse and resume previous conversations.

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

Flag	Behavior
(default)	Interactive list, inline (doesn't take over the full screen)
-m preview	Interactive list with a scrollable preview pane below
-m plain	Non-interactive table, useful for scripting

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

Key	Action
↑ / ↓	Navigate the conversation list
Ctrl+↑ / Ctrl+↓	Jump to top / bottom of list
k / j	Scroll the preview pane up/down
gg / G	Jump to top / bottom of preview pane
/	Search / filter conversations (pre-filled with current search term)
Enter	Resume selected conversation
s	Show selected conversation as markdown in terminal
w	Write selected conversation to a markdown file
q / Esc	Quit

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