Community코딩 & 개발github.com

kunolabs/codeprism

AI 코딩 에이전트를 위한 로컬 우선 컨텍스트 저장: 먼저 매핑하고, 다음에 슬라이스하고, 정확히 검색하세요.

codeprism란 무엇인가요?

kunolabs/codeprism은 AI 코딩 에이전트(예: Claude Code, Cursor 등)가 프로젝트 컨텍스트를 로컬에서 효율적으로 저장하고 검색할 수 있게 해주는 스킬입니다. 이 스킬의 핵심 아이디어는 "먼저 매핑하고, 다음에 슬라이스하고, 정확히 검색하라"입니다. 즉, 전체 코드베이스의 구조를 먼저 이해(매핑)한 후, 필요한 부분만 잘라내(슬라이스) AI 에이전트에게 정확히 전달합니다. 이를 통해 에이전트는 방대한 파일을 반복적으로 로드하지 않고도 필요한 맥락을 빠르게 파악할 수 있어, 작업 속도와 정확성이 향상됩니다. 로컬 우선이므로 데이터가 외부 서버로 유출되지 않고, Git 기반 프로젝트와 호환됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add kunolabs/codeprism

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

codeprism은(는) 무엇을 하나요?

AI 코딩 에이전트를 위한 로컬 우선 컨텍스트 저장: 먼저 매핑하고, 다음에 슬라이스하고, 정확히 검색하세요.

개요

codeprism은 AI 코딩 에이전트가 프로젝트의 컨텍스트를 효과적으로 관리할 수 있도록 설계된 스킬입니다. 반복적인 파일 로딩 없이 프로젝트 구조를 매핑하고, 필요한 부분만 슬라이스하여 정확히 검색함으로써 에이전트의 효율성을 극대화합니다.

주요 기능

  • 프로젝트 매핑: 전체 코드베이스 구조를 분석하여 트리 맵을 생성합니다.
  • 컨텍스트 슬라이싱: 필요에 따라 특정 파일이나 디렉토리의 코드만 추출합니다.
  • 정확한 검색: 자연어 기반 검색으로 관련 코드 조각을 빠르게 찾습니다.
  • 로컬 우선: 모든 데이터는 로컬에 저장되며, 외부 서버로 전송되지 않습니다.

지원 플랫폼

  • Claude Code
  • Cursor
  • Codex
  • 기타 AI 코딩 에이전트

사용 예시

# 프로젝트 매핑 생성
codeprism map ./project

# 특정 디렉토리 슬라이스
codeprism slice ./project/src

# 자연어로 파일 검색
codeprism search "사용자 로그인 처리"

설치 방법

  1. 저장소 클론:
    git clone https://github.com/kunolabs/code-prism.git
    
  2. 의존성 설치:
    npm install
    
  3. 실행 권한 설정:
    chmod +x codeprism
    

설정

codeprism.config.js 파일을 프로젝트 루트에 생성하여 설정을 변경할 수 있습니다:

module.exports = {
  exclude: ["node_modules", "dist"],
  maxDepth: 10,
  format: "tree"
};

환경 변수

  • COPRISM_MAX_FILES: 검색할 최대 파일 수 (기본값: 100)
  • COPRISM_CACHE_DIR: 캐시 디렉토리 경로 (기본값: ~/.codeprism/cache)

라이선스

MIT

관련 스킬