llm-context

Intelligently selects files from repositories by applying .gitignore patterns and custom inclusion/exclusion rules defined in YAML frontmatter. The system reads rule files from .llm-context/rules/ directory, parses gitignore-style patterns, and maintains persistent selection state across sessions. Files are categorized as either full-content or outline candidates based on rule configuration, enabling selective context injection without manual file enumeration.

Parses source code files to extract structural information (function/class definitions, imports, comments) and generates condensed outlines instead of full file content. Supports 40+ languages through language-specific parsers, enabling LLMs to understand codebase architecture without token-heavy full file dumps. Definitions are extracted as key-value pairs mapping symbol names to their locations, allowing LLMs to navigate code semantically.

Formats selected files and extracted code structures into LLM-ready context using Jinja2 templates. The system provides default templates for common scenarios (documentation review, code refactoring) and allows custom templates to be defined in .llm-context/templates/. Templates receive context variables including file lists, outlines, definitions, and project metadata, enabling flexible output formatting for different LLM chat interfaces and prompt engineering strategies.

Exposes llm-context functionality as an MCP server, allowing Claude and other MCP-compatible LLMs to request context generation on-demand through standardized protocol calls. The MCP server implements tools for file selection, context generation, and template rendering, enabling LLMs to interactively refine context without returning to the CLI. This creates a bidirectional integration where LLMs can request specific context based on their analysis needs.

Generates formatted context and copies it directly to the system clipboard, enabling one-click context injection into any LLM chat interface. Supports multiple output formats (markdown, plain text, structured JSON) and integrates with the template system to produce chat-ready context. The clipboard integration bypasses the need for file uploads or API integrations, making it compatible with any LLM interface that accepts pasted text.

Stores project-level and user-level notes in .llm-context/project-notes.md and .llm-context/user-notes.md respectively, which are automatically included in generated context. These notes provide persistent metadata about the project (architecture decisions, conventions, known issues) and user preferences (preferred coding style, analysis focus areas) that inform LLM understanding without requiring manual re-entry per session. Notes are treated as first-class context components alongside code files.

Manages the execution context through a ContextSpec object that tracks project configuration, rule selections, and file state across CLI invocations. The system persists state in .llm-context/state.json or equivalent, enabling users to save context configurations and resume them without re-specifying rules or file selections. The execution environment coordinates between file selection, context generation, and output integration, providing a unified interface for context management.

Parses and highlights source code in 40+ languages using language-specific syntax rules, enabling LLMs to understand code structure and semantics beyond plain text. The system applies syntax highlighting markers (markdown code blocks with language identifiers, or inline markers) to code snippets, improving LLM comprehension of language-specific constructs. Language detection is automatic based on file extension, with fallback to user specification.

Enables users to define custom rules that extend system rules (prefixed with 'lc-') through a 'base' property in YAML frontmatter. Rules are stored as markdown files in .llm-context/rules/ with YAML frontmatter defining file selection patterns and LLM instructions in the markdown body. This composition pattern allows rule reuse and specialization without duplication, enabling teams to build rule libraries for common scenarios (documentation review, security audit, performance analysis).

Provides a comprehensive command-line interface organized into logical command groups: project setup (initialize .llm-context directory structure), file selection (apply rules and filter files), context generation (format and prepare output), and clipboard integration (copy to clipboard). Commands are composable, allowing users to chain operations (e.g., select files with rule X, generate context with template Y, copy to clipboard). The CLI supports both interactive and scripted workflows.