fernandoabolafio/repobase

AI로 Git 저장소를 인덱싱하고 검색하세요. AI 도구 통합을 위한 터미널 UI (TUI) 및 MCP 서버를 포함합니다.

Bun 런타임이 필요합니다.

# 전역 설치
npm install -g repobase
# 또는 bun으로
...

repobase

키보드 단축키:

a

• 저장소 추가 (Add repository)
  d

• 저장소 삭제 (Delete repository)
  s

• 선택된 저장소 동기화 (Sync selected repository)
  S

• 모든 저장소 동기화 (Sync all repositories)
  /

• 검색 (Search)
  q

• 종료 (Quit)

MCP 설정(~/.cursor/mcp.json 또는 Claude 설정)에 추가하세요:

{
"mcpServers": {
"repobase": {
...

사용 가능한 도구 (Available tools):

list_repos

• 모든 인덱싱된 저장소 목록 표시 (List all indexed repositories)
  search

• 저장소 전체 검색 (키워드, 시맨틱(semantic) 또는 하이브리드 모드) (Search across repositories)
  list_files

• 저장소 내 파일 목록 표시 (List files in a repository)
  glob_files

• glob 패턴으로 파일 찾기 (Find files by glob pattern)
  read_file

• 파일 내용 읽기 (Read file contents)
  grep

• 정규 표현식(regex)으로 파일 내용 검색 (Search file contents with regex)

# 의존성 설치
bun install
# 개발 모드에서 TUI 실행
...

repobase/
├── packages/
│ ├── engine/ # 핵심 라이브러리 (인덱싱, 검색, git 작업) (Core library)
...

이 프로젝트는 자동화된 버전 관리 및 변경 로그(changelog) 생성을 위해 Conventional Commits를 사용합니다.

<type>(<scope>): <description>
[optional body]
[optional footer(s)]

유형 (Types):

feat:

• 새로운 기능 (minor 버전 업데이트 트리거)
  fix:

• 버그 수정 (patch 버전 업데이트 트리거)
  perf:

• 성능 개선 (patch 버전 업데이트 트리거)
  refactor:

• 코드 리팩터링 (patch 버전 업데이트 트리거)
  docs:

• 문서 변경 (릴리스 없음)
  style:

• 코드 스타일 변경 (릴리스 없음)
  test:

• 테스트 변경 (릴리스 없음)
  chore:

• 유지보수 작업 (릴리스 없음)
  ci:

• CI/CD 변경 (릴리스 없음)

중대한 변경 사항 (Breaking Changes):

메이저(major) 버전 업데이트를 트리거하려면 커밋 푸터(footer)에 BREAKING CHANGE:를 추가하거나, 유형(type) 뒤에 !를 추가하세요:

feat!: remove deprecated API
BREAKING CHANGE: The old API has been removed.

main 브랜치로의 머지 (Merges to main):

@next 태그로 npm에 릴리스 후보(release candidate)를 자동으로 게시합니다.

수동 트리거 (Manual trigger):

"Promote to Latest" 워크플로우를 실행하면 @latest로 게시되고 GitHub 릴리스가 생성됩니다.

MIT