Columbus 1.0.0

Columbus 1.0.0

콜럼버스가 코드의 지도를 펼칩니다. 저장소·명령·패키지·스킬을 Columbus 이름으로 통일하고, 나침반과 지도를 든 탐험가 캐릭터, 재현 가능한 벤치마크 그래프를 함께 담았습니다.

설치와 첫 탐색

Python 3.11 이상과 uv가 필요합니다. 설치 후 탐색할 프로젝트 디렉터리에서 실행하세요.

uv tool install https://github.com/ch4570/columbus/releases/download/v1.0.0/columbus-1.0.0-py3-none-any.whl
columbus explore
columbus explore checkout --session checkout
columbus stats checkout

pipx를 쓰면 uv tool install을 pipx install로 바꾸세요. Python만 있다면 get-columbus.py를 내려받아 실행하면 됩니다. 설치기는 wheel 체크섬과 실행 환경을 확인한 뒤 명령을 연결합니다. 설치 가이드.

포함한 기능

• 66개 언어 감지 프로필, Python·Java·Kotlin AST, 43개 선언 휴리스틱과 UTF-8 텍스트 검색.
• 증분 SQLite 색인, 심볼·호출·임포트·상속 관계 탐색과 제한된 크기의 소스 조회.
• explore, 작업별 --session, stats: 필요한 코드 탐색, 중복 소스 제외, 실제 응답량 확인.
• JSON·Mermaid·GraphML·오프라인 HTML 그래프와 선택형 MCP.
• 새 캐릭터 이미지와 영어·한국어 README, 벤치마크 JSON·그래프·생성 스크립트.

벤치마크를 읽는 법

Columbus 1.0의 CLI 응답량과 증분 색인은 실제 실행한 데이터로 그래프를 만들었습니다. 이전 RepoAtlas 0.4.0의 실제 Codex 탐색도 별도로 보여줍니다. 도구 출력 바이트와 실제 모델 입력 토큰은 다른 측정입니다. 이전 실험에서 양쪽 인용이 통과한 사례는 입력이 34.0% 증가했으며, 일반적인 모델 토큰 절감을 입증했다고 주장하지 않습니다. 그래프·원본·재현 방법.

프리뷰에서 이전하기

새 명령은 columbus, 스킬은 .agents/skills/columbus/, 색인은 .columbus/index-v1.sqlite입니다. 사용자 설정은 .columbus.json 또는 .columbusignore로 옮기세요. 이전 .repoatlas/와 스킬 설치는 자동 변경하지 않습니다. 새 색인과 세션으로 시작합니다.

배포 파일과 검증

columbus-1.0.0-py3-none-any.whl, columbus-1.0.0.zip, get-columbus.py, SHA256SUMS.txt를 제공합니다. wheel은 CLI·스킬을, ZIP은 문서·예제·테스트·벤치마크 근거까지 포함합니다. Ubuntu·macOS·Windows와 Python 3.11·3.14의 6개 CI 작업을 통과했습니다. Ubuntu·macOS의 4개 조합에서 각각 230개, Windows 3.11에서 229개, Windows 3.14에서 228개 테스트가 통과했습니다. Windows에서는 POSIX 전용 검사 1개를 제외하며, Python 3.14에서는 호환되지 않는 과거 RepoAtlas 0.4 재현 검사 1개도 제외합니다. 현재 Columbus 엔진과 실제 배포 검사는 모두 실행했습니다. 최신 실행 근거와 플랫폼별 범위는 검증 기록에 정리합니다.

Columbus · 한국어 소개

RepoAtlas 0.5.0 · 비공개 프리뷰

RepoAtlas 0.5.0

설치한 뒤 repoatlas explore로 바로 저장소를 살펴보는 첫 비공개 프리뷰 릴리스입니다. 코드 그래프, 작업별 컨텍스트, 관측 결과를 함께 제공합니다.

시작하기

탐색할 프로젝트 디렉터리에서 실행하세요. 저장소 접근 권한, 로그인된 GitHub CLI, Python 3.11 이상과 uv가 필요합니다. 릴리스 페이지에서 직접 wheel을 내려받아도 됩니다.

gh release download v0.5.0 --repo ch4570/repo-graph --pattern 'repoatlas-0.5.0-py3-none-any.whl'
uv tool install ./repoatlas-0.5.0-py3-none-any.whl
repoatlas explore
repoatlas explore checkout --session checkout
repoatlas stats checkout

pipx 사용자는 uv tool install을 pipx install로 바꿀 수 있습니다. Python만 있다면 아래 자산에서 get-repoatlas.py, wheel, SHA256SUMS.txt를 내려받아 python3 get-repoatlas.py --wheel ./repoatlas-0.5.0-py3-none-any.whl --checksum-file ./SHA256SUMS.txt로 실행하세요. Windows에서는 python3를 py -3로 바꿉니다. 설치기가 사용자 전용 환경을 만들고 명령 위치를 안내합니다.

저장소 공개 범위는 비공개로 유지합니다. 제품 이름과 브랜딩 정리 후 공개 여부를 별도로 결정합니다.

포함한 기능

• Python·Java·Kotlin AST, 43개 선언 휴리스틱을 포함한 66개 언어 감지 프로필과 미지원 UTF-8 텍스트 검색.
• 증분 SQLite 색인, 심볼·관계·영향 탐색, JSON·Mermaid·GraphML·오프라인 HTML 그래프.
• explore [QUERY]: 자동 색인, 읽기 쉬운 text, 기본 2,000 추정 토큰. 기존 JSON 명령과 선택형 MCP 7개 도구 유지.
• --session NAME: 중복 소스 범위를 제외하고 남은 코드를 이어 읽는 receipt와 로컬 metadata 기록. stats NAME으로 집계.
• 긴 함수의 관련 부분 발췌, 정확한 이름 검색의 헤더 유지, 원본·디코딩 해시를 함께 검증하는 최신성 검사.
• 체크섬을 확인하는 Python-only 설치기, 사용자 전용 venv, 기존 명령을 보존하는 업데이트, 오프라인 wheelhouse 지원.

관측 결과

README에 결과와 한계를 직접 담았습니다. 0.4.0 예제 측정에서 같은 28개 지도 항목의 응답은 JSON 대비 text가 46.8% 작았고, 같은 context 세 번의 전체 응답은 receipt 사용 시 53.5% 줄었습니다.

실제 Codex 탐색 6회에서는 일반적인 모델 토큰 절감을 입증하지 못했습니다. 양쪽 답변이 인용 검사를 통과한 사례에서는 누적 입력이 34.0% 증가했습니다. 초기 빈 색인 실험과 인용 실패도 보존했습니다. 0.5.0의 세션 편의 기능에 새로운 모델 토큰 절감률을 붙이지 않습니다.

배포 파일

• repoatlas-0.5.0-py3-none-any.whl: uv·pipx·전용 venv에 설치하는 CLI와 스킬.
• repoatlas-0.5.0.zip: 설치 코드·문서·예제·테스트·관측 근거를 포함한 소스 번들.
• get-repoatlas.py: pipx/uv 없이 실행하는 사용자 설치기.
• SHA256SUMS.txt: 위 세 파일의 SHA-256.

이번 비공개 프리뷰는 로컬 테스트 208개와 macOS·Linux의 Python 3.11·3.14 설치 검증을 마친 산출물을 수동 게시합니다. GitHub Actions는 계정 결제 또는 사용 한도 문제로 작업 시작 전에 차단됐습니다. 원격 CI 및 Windows 통과를 주장하지 않습니다. 자동 정식 릴리스 워크플로는 태그·패키지 버전 확인과 6개 플랫폼 검증을 여전히 요구합니다. 분석 수준은 언어에 따라 AST·heuristic·text로 다르며 모든 런타임 호출을 증명하지 않습니다.

README · 한국어 소개 · 설치 가이드 · 관측 기록