CTX: Context as Code (CaC) tool

ctx: 코드베이스와 LLM을 연결하는 미싱 링크. MCP 서버가 내장된 Context as Code(CaC) 도구입니다.

목차

• 작동 원리
• 빠른 시작
• 전체 문서
• 특허

CTX는 ChatGPT나 Claude와 같은 LLM과 채팅할 때 발생하는 큰 문제, 즉 프로젝트에 대한 충분한 맥락을 제공하기 위해 만들어진 도구입니다.

Medium 에 Context Generator에 대한 기사가 있는데, 이 프로젝트의 동기와 이 프로젝트가 해결하는 문제에 대해 설명하고 있습니다.

개발 과정에서 AI를 사용할 때 컨텍스트는 단순히 도움이 되는 것이 아니라 모든 것을 의미합니다. 전체 코드베이스를 매번 수동으로 복사하거나 설명하는 대신, ctx는 다음 파일들을 사용하여 깔끔하고 체계적인 컨텍스트 파일을 자동으로 생성합니다.

• 코드 파일,
• GitHub 및 Gitlab 저장소,
• Git 커밋 및 diff
• CSS 선택기를 사용한 웹 페이지(URL)
• MCP 서버
• 그리고 일반 텍스트.

이는 일반적인 문제, 즉 클로드와 같은 AI 언어 모델에 코드베이스에 대한 필요한 컨텍스트를 효율적으로 제공하는 문제를 해결하기 위해 만들어졌습니다.

작동 원리

1. 파일, 디렉토리, GitHub 또는 Gitlab 저장소, 웹 페이지 또는 일반 텍스트에서 코드를 수집합니다.
2. 패턴 매칭, 콘텐츠 검색, 크기 또는 날짜 필터를 통해 특정 파일을 타겟팅합니다.
3. 선택적 수정자(구현 세부 정보 없이 PHP 서명 추출 등)를 적용합니다.
4. 콘텐츠를 잘 구성된 마크다운 문서로 구성합니다.
5. LLM과 공유할 준비가 된 컨텍스트 파일을 저장합니다.
6. 선택적으로 MCP 서버를 통해 컨텍스트를 제공하여 Claude와 같은 AI 지원자가 프로젝트 정보에 직접 액세스할 수 있도록 합니다.

빠른 시작

CTX를 시작하는 것은 간단합니다. 다음의 간단한 단계에 따라 첫 번째 컨텍스트 파일을 만드세요.

1. CTX 설치

설치 스크립트를 사용하여 도구를 다운로드하고 설치하세요.

지엑스피1

이렇게 하면 ctx 명령이 시스템에 설치됩니다(일반적으로 /usr/local/bin 에 있음).

더 많은 옵션을 원하시나요? 다른 설치 방법은 전체 설치 가이드를 참조하세요.

2. 구성 파일 초기화

프로젝트 디렉토리에 새 구성 파일을 만듭니다.

이렇게 하면 시작할 수 있는 기본 구조의 context.yaml 파일이 생성됩니다.

사용 가능한 모든 명령과 옵션은 명령 참조에서 확인하세요.

3. 프로젝트 구조를 설명하세요

생성된 context.yaml 파일을 편집하여 포함하려는 코드나 콘텐츠를 지정합니다.

예를 들어:

이 구성은 src/Auth 디렉토리의 모든 PHP 파일과 src/Models 디렉토리의 이름에 "User"가 포함된 모든 PHP 파일을 수집합니다.

더욱 고급 구성이 필요하신가요?

• 문서 구조 및 속성에 대해 알아보세요
• GitHub , Git Diff 또는 URL과 같은 다양한 소스 유형을 탐색하세요.
• 콘텐츠를 변환하기 위해 수정자 적용(PHP 서명 추출 등)
• 구성에서 환경 변수를 사용하는 방법을 알아보세요
• 자동 완성 및 검증을 위해 IDE 통합을 사용하세요

4. 맥락 구축

다음을 실행하여 컨텍스트 파일을 생성합니다.

CTX는 구성을 처리하고 지정된 출력 파일(예시에서는 auth-context.md )을 생성합니다.

팁 : 자세한 출력을 위해 -v , -vv 또는 -vvv 로 로깅을 구성하세요.

5. LLM과 공유

생성된 컨텍스트 파일을 선호하는 LLM(예: ChatGPT 또는 Claude)에 업로드하거나 붙여넣으세요. 이제 코드베이스에 대한 구체적인 질문을 할 수 있으며, LLM은 정확한 지원을 제공하는 데 필요한 컨텍스트를 갖게 됩니다.

예시 프롬프트:

제 인증 시스템 코드를 공유했습니다. 사용자 등록 과정에서 잠재적인 보안 취약점을 파악하는 데 도움을 주시겠습니까?

다음 단계: AI 기반 개발 워크플로에 컨텍스트 생성을 통합하는 모범 사례를 알아보려면 Context Generator를 사용한 개발을 확인하세요.

이제 코드베이스에 대한 적절한 맥락을 바탕으로 LLM을 활용할 준비가 되었습니다.

6. Claude AI에 연결(선택 사항)

더욱 원활한 경험을 위해 MCP 서버를 사용하여 Context Generator를 Claude AI에 직접 연결할 수 있습니다.

Claude AI를 코드베이스에 직접 연결할 수 있는 내장 MCP 서버가 있습니다.

MCP 클라이언트를 Context Generator 서버로 지정합니다.

참고: 자세한 설정 지침은 MCP 서버 에 대해 자세히 알아보세요.

이제 컨텍스트 파일을 수동으로 업로드하지 않고도 Claude에게 코드베이스에 대한 질문을 할 수 있습니다!

전체 문서

사용 가능한 모든 기능과 구성 옵션을 포함한 전체 설명서는 다음에서 확인하세요.

https://docs.ctxgithub.com

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다.