llm-컨텍스트

LLM 컨텍스트

LLM 컨텍스트는 개발자가 코드/텍스트 프로젝트의 관련 콘텐츠를 대규모 언어 모델(LLM) 채팅 인터페이스에 신속하게 삽입할 수 있도록 지원하는 도구입니다. .gitignore 패턴을 활용하여 스마트한 파일 선택을 지원하고, 명령줄을 사용한 간소화된 클립보드 워크플로와 모델 컨텍스트 프로토콜(MCP)을 통한 LLM과의 직접적인 통합을 제공합니다.

참고 : 이 프로젝트는 Claude Sonnet 3.5, 3.6, 3.7(그리고 최근에는 Grok-3도 포함) 여러 버전과 협력하여 개발되었으며, 개발 과정에서 코드를 공유하기 위해 LLM Context 자체를 사용했습니다. 저장소의 모든 코드는 제가 직접 큐레이션했습니다(😇, @restlessronin).

v0.3.0의 주요 변경 사항

기존의 TOML/YAML 기반 프로필을 마크다운(+ YAML 머리말) 기반 규칙 시스템으로 대체했습니다. 이는 구성에 영향을 미치는 중대한 변경 사항입니다. 새로운 규칙 형식과 사용 방법에 대한 자세한 내용은 사용자 가이드를 참조하세요.

왜 LLM Context인가?

LLM Context와 AI 지원 개발에 대한 접근 방식의 근거에 대한 심층적인 탐구를 위해 다음 기사를 확인하세요. LLM Context: 개발을 위한 Vanilla AI 채팅 활용

실제 사례와 워크플로를 통해 LLM 컨텍스트가 어떻게 작동하는지 알아보려면 다음을 읽어보세요. Full Context Magic - AI가 마침내 전체 프로젝트를 이해하는 순간

현재 사용 패턴

직접 LLM 통합 : MCP 프로토콜을 통한 Claude Desktop과의 기본 통합
채팅 인터페이스 지원 : CLI/클립보드를 통해 모든 LLM 채팅 인터페이스와 호환됩니다.
- Claude Projects 및 Custom GPT와 같은 지속적인 컨텍스트가 있는 인터페이스에 최적화됨
- 표준 채팅 인터페이스와도 잘 작동합니다.
프로젝트 유형 : 코드 저장소 및 텍스트/마크다운/HTML 문서 컬렉션에 적합
프로젝트 크기 : LLM 컨텍스트 창에 맞는 프로젝트에 최적화되어 있습니다. 대규모 프로젝트 지원은 개발 중입니다.

설치

uv를 사용하여 LLM 컨텍스트를 설치합니다.

지엑스피1

최신 버전으로 업그레이드하려면:

uv tool upgrade llm-context

경고 : LLM 컨텍스트가 현재 개발 중입니다. 업데이트 시 lc- 접두사가 붙은 구성 파일이 덮어쓰일 수 있습니다. 이러한 이유로 모든 구성 파일의 버전을 관리하는 것이 좋습니다.

빠른 시작

Claude Desktop을 사용한 MCP

'claude_desktop_config.json'에 추가:

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

구성이 완료되면 두 가지 간단한 방법으로 프로젝트 작업을 시작할 수 있습니다.

"저는 제 프로젝트에 참여하고 싶습니다"라고 말하면 클로드가 프로젝트 루트 경로를 묻습니다.
또는 직접 지정하세요: "저는 /path/to/your/project 프로젝트로 작업하고 싶습니다." Claude가 자동으로 프로젝트 컨텍스트를 로드합니다.

선호되는 워크플로: 프로젝트 UI와 MCP 결합

최적의 결과를 얻으려면 Claude의 프로젝트 지식 UI를 통한 초기 컨텍스트와 MCP를 통한 동적 코드 접근을 결합하세요. 이를 통해 포괄적인 이해와 최신 변경 사항에 대한 접근을 모두 확보할 수 있습니다. 자세한 내용과 예시는 Full Context Magic을 참조하세요.

CLI 빠른 시작 및 일반적인 워크플로

프로젝트의 루트 디렉토리로 이동합니다.
저장소 초기화: lc-init (한 번만 필요)
파일 선택: lc-sel-files
(선택 사항) .llm-context/curr_ctx.yaml 에서 선택한 파일을 검토합니다.
컨텍스트 생성: lc-context (선택적 플래그: 프롬프트의 경우 -p , 사용자 메모의 경우 -u )
원하는 인터페이스와 함께 사용하세요:

프로젝트 지식(Claude Pro): 지식 섹션에 붙여넣기
GPT 지식(사용자 지정 GPT): 지식 섹션에 붙여넣기
일반 채팅: lc-context -p 사용하여 지침을 포함합니다.

LLM이 추가 파일을 요청하는 경우:
- LLM에서 파일 목록을 복사합니다.
- lc-clip-files 실행하세요
- 내용을 LLM에 다시 붙여넣습니다.

핵심 명령

lc-init : 프로젝트 구성 초기화
lc-set-rule <n> : 스위치 규칙(시스템 규칙은 "lc-" 접두사가 붙습니다)
lc-sel-files : 포함할 파일 선택
lc-sel-outlines : 개요 생성을 위한 파일 선택
lc-context [-p] [-u] [-f FILE] : 컨텍스트 생성 및 복사
- -p : 프롬프트 지침을 포함합니다.
- -u : 사용자 메모 포함
- -f FILE : 출력 파일에 쓰기
lc-prompt : LLM을 위한 프로젝트 지침 생성
lc-clip-files : LLM 파일 요청 처리
lc-changed : 마지막 컨텍스트 생성 이후 수정된 파일 목록
lc-outlines : 코드 파일에 대한 개요 생성
lc-clip-implementations : LLM에서 요청한 코드 구현을 추출합니다(C/C++는 지원하지 않음)

기능 및 고급 사용법

LLM Context는 프로젝트 콘텐츠를 캡처하고 표현하는 방법을 사용자 정의하기 위한 고급 기능을 제공합니다.

.gitignore 패턴을 사용한 스마트 파일 선택
다양한 사용 사례에 대한 여러 규칙 기반 프로필
- 시스템 규칙(접두사 "lc-" 포함)은 기본 기능을 제공합니다.
- 사용자 정의 규칙은 독립적으로 생성하거나 기존 규칙을 확장할 수 있습니다.
코드 탐색 기능:
1. 스마트 코드 개요 : LLM이 중요한 정의를 강조하는 자동 생성 개요를 통해 코드베이스의 상위 수준 구조를 볼 수 있도록 합니다.
2. 정의 구현 추출 : LLM이 코드 개요를 검토한 후 lc-clip-implementations 명령을 사용하여 요청한 특정 정의의 전체 구현을 붙여넣습니다.
사용자 정의 가능한 템플릿 및 프롬프트

이러한 기능에 대한 자세한 내용은 사용자 가이드를 참조하세요.

유사한 도구

대안에 대한 포괄적인 목록을 확인해 보세요. 이 문제를 해결하는 도구의 엄청난 수는 개발자 커뮤니티에 이 문제가 얼마나 중요한지를 보여줍니다.

감사의 말

LLM 컨텍스트는 AI 지원 개발 도구의 계통에서 발전했습니다.

이 프로젝트는 IDE 통합을 위해 개발한 TypeScript 라이브러리인 LLM Code Highlighter의 후속 프로젝트입니다.
이 개념은 RubberDuck 에서의 제 작업에서 유래되었으며 이후 Continue 에 기여하면서 계속 이어졌습니다.
LLM 코드 하이라이터는 Aider Chat 에서 많은 영감을 받았습니다. 저는 GPT-4와 협력하여 여러 Aider Chat Python 모듈을 TypeScript로 변환하면서 기능을 유지하면서 코드를 재구성했습니다.
이 프로젝트에서는 Aider Chat의 tree-sitter 태그 쿼리 파일을 사용합니다.
LLM Context는 GPT-4와 Claude-3.5-Sonnet의 도움으로 Python에서 TypeScript로, 그리고 다시 Python으로 전환하면서 AI 지원 개발의 힘을 보여줍니다.

저는 이 프로젝트의 발전을 형성한 오픈소스 커뮤니티의 혁신과 AI 지원에 감사드립니다.

이 프로젝트 개발에 도움을 주신 Claude-3.5-Sonnet에게 감사드립니다.

특허

이 프로젝트는 Apache 라이선스 버전 2.0에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.

llm-context