LLM Context

.gitignore

Note: This project was developed in collaboration with several Claude Sonnets - 3.5, 3.6 and 3.7 (and more recently Grok-3 as well), using LLM Context itself to share code during development. All code in the repository is human-curated (by me 😇, @restlessronin).

Breaking Changes in v0.3.0

Why LLM Context?

Current Usage Patterns

• Direct LLM Integration: Native integration with Claude Desktop via MCP protocol
• Chat Interface Support: Works with any LLM chat interface via CLI/clipboard
  • Optimized for interfaces with persistent context like Claude Projects and Custom GPTs
  • Works equally well with standard chat interfaces
• Project Types: Suitable for code repositories and collections of text/markdown/html documents
• Project Size: Optimized for projects that fit within an LLM's context window. Large project support is in development

Installation

uv tool install "llm-context>=0.3.0"

uv tool upgrade llm-context

Warning: LLM Context is under active development. Updates may overwrite configuration files prefixed with

lc-

. We recommend all configuration files be version controlled for this reason.

Quickstart

MCP with Claude Desktop

{
  "mcpServers": {
    "CyberChitta": {
      "command": "uvx",
      "args": ["--from", "llm-context", "lc-mcp"]
    }
  }
}

1. Say: "I would like to work with my project" Claude will ask you for the project root path.
2. Or directly specify: "I would like to work with my project /path/to/your/project" Claude will automatically load the project context.

Preferred Workflow: Combining Project UI with MCP

CLI Quick Start and Typical Workflow

1. Navigate to your project's root directory
2. Initialize repository:

   lc-init

   (only needed once)
3. Select files:

   lc-sel-files

4. (Optional) Review selected files in

   .llm-context/curr_ctx.yaml

5. Generate context:

   lc-context

   (with optional flags:

   -p

   for prompt,

   -u

   for user notes)
6. Use with your preferred interface:

• Project Knowledge (Claude Pro): Paste into knowledge section
• GPT Knowledge (Custom GPTs): Paste into knowledge section
• Regular chats: Use

  lc-context -p

  to include instructions

1. When the LLM requests additional files:
   • Copy the file list from the LLM
   • Run

     lc-clip-files

   • Paste the contents back to the LLM

Core Commands

• lc-init

  : Initialize project configuration

• lc-set-rule <n>

  : Switch rules (system rules are prefixed with "lc-")

• lc-sel-files

  : Select files for inclusion

• lc-sel-outlines

  : Select files for outline generation

• lc-context [-p] [-u] [-f FILE]

  : Generate and copy context

  • -p

    : Include prompt instructions

  • -u

    : Include user notes

  • -f FILE

    : Write to output file

• lc-prompt

  : Generate project instructions for LLMs

• lc-clip-files

  : Process LLM file requests

• lc-changed

  : List files modified since last context generation

• lc-outlines

  : Generate outlines for code files

• lc-clip-implementations

  : Extract code implementations requested by LLMs (doesn't support C/C++)

Features & Advanced Usage

• Smart file selection using

  .gitignore

  patterns
• Multiple rule-based profiles for different use cases
  • System rules (prefixed with "lc-") provide default functionality
  • User-defined rules can be created independently or extend existing rules
• Code Navigation Features:
  1. Smart Code Outlines: Allows LLMs to view the high-level structure of your codebase with automatically generated outlines highlighting important definitions
  2. Definition Implementation Extraction: Paste full implementations of specific definitions that are requested by LLMs after they review the code outlines, using the

     lc-clip-implementations

     command
• Customizable templates and prompts

Similar Tools

Acknowledgments

• This project succeeds LLM Code Highlighter, a TypeScript library I developed for IDE integration.
• The concept originated from my work on RubberDuck and continued with later contributions to Continue.
• LLM Code Highlighter was heavily inspired by Aider Chat. I worked with GPT-4 to translate several Aider Chat Python modules into TypeScript, maintaining functionality while restructuring the code.
• This project uses tree-sitter tag query files from Aider Chat.
• LLM Context exemplifies the power of AI-assisted development, transitioning from Python to TypeScript and back to Python with the help of GPT-4 and Claude-3.5-Sonnet.

License