Skip to content
convo

OPEN SOURCE. TERMINAL NATIVE.

Your files.
A conversation.

Ask your files anything. Get answers with sources.
All from the terminal you already call home.

macOS / Linux
uv tool install convo-cli

Requires uv ↗ and Docker or Podman for local storage.

A little less searching. A little more knowing.
Convo terminal showing a question about a RAG pipeline, an answer with code, and a supporting source quotation from architecture.md.
One file. Real context. Cited answers.

From directory to dialogue.

Open your terminal. Bring a file. Start a convo.

  1. Meet Convo in your directory

    Move into the folder with your files, then launch Convo.

    cd ~/Documents
    convo

    Or browse another folder with convo --directory ~/Documents. First launch prepares your local database.

  2. Connect. Pick a file.

    Use /login to connect your ChatGPT account in the browser. Then use /file to select and index a file.

    /login/models/file

    Choose your model with /models. The first file downloads the local embedding and reranking models.

  3. Ask away. Follow the sources.

    Type a question and press Enter. Read the answer alongside quotations from your selected file.

    What are the key ideas in this document?

    Conversations save automatically. Pick up where you left off with /sessions.