Git History Viewer

브라우저, CLI 및 MCP 클라이언트를 위한 무료 로컬 우선(local-first) 읽기 전용 Git 히스토리 그래프입니다.

공개 알파입니다. 관리되는 환경에서는 정확한 버전을 고정하세요.

설치

Node.js 22 이상과 Git 2.40 이상이 필요합니다.

npm install --global @peekaboo-develop/git-history-viewer@alpha

Related MCP server: git-insights-mcp

저장소 열기

cd /path/to/repository
git-history-viewer web .

뷰어는 해당 작업 복사본(working copy)에 대해 루프백 전용 브라우저 세션을 엽니다. Git 상태를 복제하거나, 가져오거나, 풀하거나, 푸시하거나 수정하지 않습니다. 원격 추적 refs는 기존 Git 워크플로에서 마지막으로 가져온 상태를 표시합니다.

MCP 설정의 경우 메타데이터 전용 액세스부터 시작하세요:

git-history-viewer mcp --repo /absolute/path/to/repository --content-policy metadata

개발

npm install
npm test
npm run license:check
npm run test:pack
node bin/git-history-viewer.mjs web . --port 0 --no-open
node bin/git-history-viewer.mjs web . --port 0 --no-open --ollama-model qwen3:4b
node bin/git-history-viewer.mjs config path
node bin/git-history-viewer.mjs config validate
node bin/git-history-viewer.mjs profiles list
node bin/git-history-viewer.mjs web . --ai-profile local-fast --ai-profile local-deep
node bin/git-history-viewer.mjs mcp --repo /absolute/path --content-policy metadata
node bin/git-history-viewer.mjs cache status

기본 MCP 정책은 패치, 작성자 이메일 또는 절대 경로를 노출하지 않습니다. 애플리케이션은 Git 상태를 가져오거나 변경하지 않습니다.

웹 헤더에는 검증된 Codex, Claude Code 및 Cursor MCP 설정 템플릿을 위한 AI제이안내 가 포함되어 있습니다. 클라이언트 구성을 편집하거나 저장소의 절대 경로를 노출하지 않습니다. 선택한 커밋은 해당 OID만 포함하는 짧은 MCP 프롬프트를 생성할 수 있습니다.

선택적 웹 AI 흐름은 --ai-profile 또는 레거시 --ollama-model 옵션이 제공되지 않는 한 비활성화됩니다. 프로필은 숫자 루프백 Ollama와 공식 OpenAI, Anthropic, Google API를 지원합니다. 모든 공급자는 정확한 메타데이터 페이로드를 미리 보여 주며 생성 전에 두 번째 클릭이 필요합니다. 여러 프로필이 활성화되면 상세 창에서 모델 선택기를 제공합니다. 원격 엔드포인트와 자격 증명 이름은 코드에 고정되어 있습니다. OpenAI는 OPENAI_API_KEY를 읽고, Anthropic은 ANTHROPIC_API_KEY를 읽으며, Google은 GEMINI_API_KEY를 읽습니다. 키는 브라우저나 구성 파일에서 절대 수락되지 않습니다. 루프백만으로는 Ollama가 모델을 실행하는 위치를 증명하지 않습니다. 패치, 파일 내용, ID, 절대 경로, refs, 원격 저장소 및 커밋 ID는 전송되지 않습니다.

구성 경로는 특정 운영 체제에 따라 다르며 config path로 출력합니다. 엄격한 JSON 형식은 자격 증명, 임의의 엔드포인트, 프롬프트 또는 환경 변수 이름을 저장하지 않습니다:

{
  "schemaVersion": "1",
  "defaultProfileId": "local-fast",
  "profiles": [
    {
      "id": "local-fast",
      "label": "Local fast",
      "provider": "ollama",
      "model": "qwen3:4b",
      "ollamaPort": 11434,
      "maxOutputTokens": 1536
    },
    {
      "id": "openai-fast",
      "label": "OpenAI fast",
      "provider": "openai",
      "model": "gpt-5.4-mini",
      "maxOutputTokens": 1536
    },
    {
      "id": "claude-balanced",
      "label": "Claude balanced",
      "provider": "anthropic",
      "model": "claude-sonnet-4-6",
      "maxOutputTokens": 1536
    },
    {
      "id": "gemini-fast",
      "label": "Gemini fast",
      "provider": "google",
      "model": "gemini-2.5-flash",
      "maxOutputTokens": 1536
    }
  ]
}

구성 변경은 재시작이 필요합니다. --ai-profile은 반복 가능하며 해당 웹 세션의 명시적 허용 목록입니다. 원격 프로필을 선택할 때만 해당하는 고정 키을 내보내세요.

AI 결과 캐시는 운영 체제의 사용자 캐시 디렉터리에 있는 크기가 제한된 JSON 샤드를 사용합니다. 캐시 메타데이터는 API 키, 원시 프롬프트, diff, 저장소 경로 또는 원격 URL을 저장하지 않습니다. 생성된 결과에는 민감한 소스 텍스트가 여전히 포함될 수 있습니다. --no-ai-cache는 읽기와 쓰기를 우회합니다. cache clear는 식별된 캐시 파일(들)만 제거합니다.

커밋 세부 정보 패널은 강력한 경로 마커에 대한 공식 문서의 컴파일된 레지스트리에서 최대 두 개의 버전 중립적 무료 링크를 추천할 수 있습니다(예: GitHub Actions 워크플로, Docker/Compose 파일, TSConfig, Vite config, Vue SFC). 링크 표시는 네트워크 액세스를 수행하지 않습니다.

별도의 버튼은 DNS 리바인딩 방지 핀 IP HTTPS 전송을 통해 해당 공식 URL에서 직접 제한된 발췌문을 가져올 수 있습니다. 대상은 감지된 기술을 추론할 수 있지만, 저장소 이름, 경로, 커밋, 메시지, 쿠키, 자격 증명 및 리퍼러는 전송되지 않습니다. 리다이렉트는 거부됩니다.

AI가 활성 상태이면 다른 별도의 프리뷰를 제공하고 표시된 발췌 문서와 불투명한 인용 ID를 선택한 공급자에게 보낼 수 있습니다. 공식 URL과 제목은 모델에 전송되지 않으며 서버에서만 역으로 매핑합니다. 버전 감지는 여전히 사용할 수 없습니다.

권장 설계에 대한 자세한 내용은 docs/PRODUCT_SPEC.md, docs/ARCHITECTURE.md, docs/MCP.md, docs/SECURITY.md, docs/ROADMAP.md를 참조하세요.

릴리스 준비 및 롤백은 docs/RELEASING.md에 문서화되어 있습니다. 아티팩트를 빌드해도 게시가 승인되는 것은 아닙니다.