Lectic

MCP.Pizza Chef: gleachkr

Lectic is a conversational LLM client that stores each conversation as a markdown file, enabling natural persistence, version control, and easy management with existing markdown tools. It supports research, reflection, self-study, and design by allowing content references, integration with MCP servers and tools, and multi-LLM conversations for diverse perspectives.

Use This MCP client To

Manage LLM conversations as version-controlled markdown files Integrate multiple LLMs in one conversation for diverse insights Reference and search conversational context using markdown tools Combine LLM outputs with MCP servers for computation and database access Use markdown files for easy sharing and collaboration on conversations Support research and self-study with persistent conversational records

README

Lectic

Lectic is no-nonsense conversational LLM client. Each conversation is a simple markdown file. That means that each conversation is naturally persistent and can be easily version-controlled, searched, referenced, and managed with existing markdown tools. Lectic aims to support research, reflection, self-study, and design. So Lectic makes it easy to manage conversational context using content references, integrate with MCP servers and other tools (for search, computation, database access, and more) and include multiple LLMs in a single conversation in order to bring a variety of perspectives to bear on a problem.

Getting Started

Installation

  • If you're using nix, then nix profile install github:gleachkr/lectic will install lectic from the lastest git commit.
  • If you're not using nix, but you're using a Linux system (or WSL on windows), you can download an app image from the releases, and place it somewhere on your $PATH.
  • If you're on MacOS, you can download a binary from the releases, and place it somewhere on your $PATH.

Basic Workflow

  1. Create a new conversation file with a YAML header:

    ---
    interlocutor:
        name: Assistant
        provider: anthropic|openai|gemini|openrouter|ollama
        prompt: Your base prompt here
    ---
    
    Your initial message here

    To use the remote providers , you'll need ANTHROPIC_API_KEY, GEMINI_API_KEY, OPENAI_API_KEY, or OPENROUTER_API_KEY set in your environment. If the provider field is omitted, the default provider will be based on the alphabetically first API key defined in the your environment.

  2. Use your text editor to interact with the LLM:

    • In Vim: Use %!lectic to update the conversation
    • In other editors: Set up a key binding or command to pipe the current file through lectic
  3. Or, From the command line: lectic -s -f conversation.lec will stream a next message to the console, and lectic -i conversation.lec will update the lectic file in-place.

Editor Integration

Lectic FAQ

How does Lectic store conversations?
Lectic stores each conversation as a markdown file, enabling persistence and version control.
Can I use multiple LLMs in a single Lectic conversation?
Yes, Lectic supports including multiple LLMs in one conversation for varied perspectives.
How does Lectic integrate with other MCP servers or tools?
Lectic can connect with MCP servers for search, computation, database access, and more.
Is Lectic suitable for research and self-study?
Yes, it is designed to support research, reflection, self-study, and design workflows.
What platforms does Lectic support?
Lectic supports Linux systems and WSL on Windows, with installation via nix or app images.
How can I manage conversational context in Lectic?
Lectic uses markdown content references to manage and organize conversational context effectively.
Can I version control my conversations?
Yes, since conversations are markdown files, they can be version-controlled with git or other tools.
Does Lectic support searching within conversations?
Yes, you can search conversations using standard markdown tools and integrations.