CommitLore
curl -fsSL https://raw.githubusercontent.com/MongLong0214/commitlore/v1.2.0/install.sh | sh -s v1.2.0curl -fsSLO https://raw.githubusercontent.com/MongLong0214/commitlore/v1.2.0/install.sh
sh install.sh v1.2.0
# Or skip the script: the checkout it makes is one you can make yourself.
git clone --depth 1 --branch v1.2.0 https://github.com/MongLong0214/commitlore
node commitlore/dist/commitlore.mjs --version고정된 소스 체크아웃과 node <checkout>/dist/commitlore.mjs를 실행하는 래퍼를 설치합니다. 컴파일된 다운로드나 빌드 단계가 없습니다.
코드는 살아남는다. 판단은 그렇지 않다.
에이전트가 접근 방식을 제안합니다. 팀이 명확하지 않은 제약 때문에 이를 거부합니다. 최종 코드는 결과를 보존하지만, 대안이 왜 거부되었는지는 보통 보존하지 않습니다. 나중의 에이전트는 코드만 보고 같은 아이디어를 다시 제안합니다.
CommitLore는 그 판단을 코드 옆에 보관합니다.
CommitLore가 하는 일
동작 | 제품 경로 | |
캡처 | diff가 보여줄 수 없는 제약, 기각된 대안, 경고를 보존합니다. 후보는 세션 기록과 스테이징된 diff에 대해 확인됩니다. |
|
보존 | 승인된 기록을 호스팅 메모리 데이터베이스 대신 Git 트레일러 또는 노트에 저장합니다. | 커밋 훅 · |
수명 주기 추적 | 활성, 대체, 만료된 결정을 구분합니다. |
|
범위 지정 | 에이전트가 편집하려는 경로에 대한 결정을 선택합니다. |
|
신뢰 등급 | 기록을 지시, 주장, 또는 차단된 콘텐츠로 전달합니다. | 기본 / 서명 모드 |
전달 | 편집 전에 지원되는 에이전트에게 현재 컨텍스트를 제공합니다. | 플러그인 훅 · MCP |
대부분의 커밋은 기록을 담지 않아야 합니다. CommitLore는 코드가 보존할 수 없는 판단을 위한 것이지, 모든 변경을 서술하기 위한 것이 아닙니다.
Related MCP server: memini
결정 인식 에이전트까지 60초
1. CLI 설치
macOS 및 Linux:
curl -fsSL https://raw.githubusercontent.com/MongLong0214/commitlore/v1.2.0/install.sh | sh -s v1.2.0Windows:
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/MongLong0214/commitlore/v1.2.0/install.ps1))) v1.2.0Node.js 22.23.2+ 및 Git이 필요합니다. 스크립트는 무엇이든 쓰기 전에 둘 다 확인합니다.
2. 에이전트 연결
Claude Code:
/plugin marketplace add MongLong0214/commitlore
/plugin install commitlore@commitloreCodex:
commitlore plugin install-codex플러그인은 PATH에 commitlore를 넣지 않으므로 아래 명령에는 CLI 설치도 필요합니다. 설치 프로그램은 안전하게 수행할 수 있는 경우 지원되는 MCP 호스트도 감지하고 연결합니다. 정확한 매트릭스는 아래에 있습니다.
3. 저장소 초기화
cd your-repository
commitlore init
commitlore context .플러그인을 설치하거나 업데이트한 후 새 에이전트 세션을 시작하세요. 실행 중인 세션은 로드한 런타임을 유지합니다.
그런 다음 평소처럼 작업하고 커밋하세요. 지원되는 스킬 통합에서 CommitLore는 일반 커밋 요청 중에 고려되며 보존할 가치가 없을 때는 조용히 있습니다. 모든 커밋에서 CommitLore를 언급할 필요는 없습니다.
승인된 기록이 기록별 프롬프트 없이 스테이징되길 원하나요? 저장소는 commitlore auto on으로 한 번 옵트인할 수 있습니다. 이 정책은 저장소가 소유하며 팀에 적용되므로 이 페이지에서 조용히 활성화되지 않습니다.
에이전트가 받는 것
src/pricing.ts를 편집하기 전:
commitlore: active records for src/pricing.ts
Limit
[claim] r-price01 calculatePrice owns final checkout pricing only
Ruled-out
[claim] r-price01 Reuse it for admin quotes |
eligibility and rounding semantics differ[claim]은 "이것을 정보로 평가하라"는 의미입니다. 저장소는 더 강력한 서명 권한 모드로 옵트인할 수 있습니다. 전달은 에이전트에게 컨텍스트를 제공합니다. 편집을 차단하지 않습니다.
왜 Git인가?
저장소는 코드 뒤에 있는 판단을 소유해야 합니다.
CommitLore는 기록을 일반 Git 트레일러와 노트에 저장하므로, 코드와 함께 분기, 병합, 복제, 검토되고 공급자 변경에도 생존합니다.
SQLite는 재구축 가능한 인덱스일 뿐입니다. 삭제해도 Git은 여전히 기록을 보유합니다.
오래된 결정을 찾는 것만으로는 충분하지 않습니다
일반 메모리 또는 검색 시스템은 묻습니다:
어떤 오래된 텍스트가 관련 있어 보이나요?
CommitLore는 묻습니다:
어떤 기록된 결정이 지금 이 경로에 여전히 적용되나요?
대체된 결정은 매우 관련성이 높을 수 있지만 현재 지침으로는 여전히 틀릴 수 있습니다. 관련성과 권위는 다른 질문입니다.
작동 방식
캡처 — 에이전트는 diff가 보여줄 수 없는 결정 컨텍스트만 초안을 작성합니다.
검증 — CommitLore는 초안을 세션 및 스테이징된 diff와 대조합니다.
보존 — 승인된 기록은 정체성과 수명 주기와 함께 Git에 저장됩니다.
전달 — 이후 편집 전에 해당 경로에 대한 활성 기록만 반환됩니다.
대부분의 커밋은 기록을 담지 않습니다. 커밋 훅은 기록이 있을 때만 검증합니다. 기록을 만들지 않습니다.
기존 훅은 덮어쓰지 않습니다. commitlore init는 core.hooksPath를 존중하며, 이미 설치된 훅을 <hook>.commitlore-chained로 이동하고 먼저 호출합니다. commitlore hooks uninstall은 원래대로 되돌립니다.
자동으로 일어나는 일
호스트 | 편집 전 전달 | 검증된 캡처 워크플로 | 결정적 매 커밋 캡처 |
Claude Code | 플러그인을 통해 자동 | 플러그인 스킬을 통해 사용 가능 | 인증되지 않음 |
Codex | 플러그인을 통해 자동 | 플러그인 스킬을 통해 사용 가능 | 인증되지 않음 |
Hermes |
| 호스트 설치 후 사용 가능 | 인증되지 않음 |
Gemini CLI, Cursor, Windsurf, opencode | 호스트가 등록을 사용하는 경우 MCP 전달 | 절차가 MCP를 통해 노출됨 | 아니요 |
| 절차만 | 절차만 | 아니요 |
"사용 가능"은 준비 → 검증 → 스테이징 워크플로가 존재한다는 의미입니다. 모든 적격 커밋이 자동으로 평가된다는 의미는 아닙니다.
지원되는 스킬 호스트의 사용자는 모든 커밋에서 "이것을 CommitLore에 기록하세요"라고 말할 필요가 없습니다. 남은 제한은 호스트 시작이며, 필수 기록별 사용자 명령이 아닙니다.
측정이 아닌 현장 보고
v1.2.0을 처음 설치하는 누군가가 관련 없는 저장소에서 한 번 실행한 것입니다. 여기 있는 어떤 것도 측정되지 않았으며 증거 로그에 없습니다. 위 단락이 여기 표에서 다루지 않는 루프를 주장하기 때문에 이 페이지에 있습니다.
그들은 에이전트에게 반올림 버그를 수정하라고 요청하고, 지나가는 말로 십진수 라이브러리가 이미 고려되었고 기각되었다고 언급하고, "커밋하세요"로 끝냈습니다. CommitLore는 언급되지 않았습니다. 커밋이 담은 것의 일부:
Ruled-out: adopting a decimal library such as Decimal.js | the backend is a
number contract, so it is meaningless
Warn: do not revert the test file to console.assert: it exits 0 even on
failure, so CI passes silently
Provenance: draftedWarn은 에이전트에게 지시된 것이 아닙니다. 작업 중에 함정에 빠졌고 다음 사람을 위해 남겼습니다. Provenance: drafted는 어떤 인간도 기록을 읽지 않았음을 기록하며, 이를 claim으로 등급을 매깁니다. 즉, 명령이 아닌 평가할 보고서로 전달됩니다.
공유 기록이 없는 이후 세션은 결국 십진수 라이브러리를 채택하라는 요청을 받았습니다. 그렇게 하지 않았고, 그 이유로 기록을 언급했습니다. 또한 등급을 읽었습니다. claim은 지시가 아니므로, 동의하기 전에 명시된 이유를 코드와 대조했습니다.
메모리 저장과 다름
일반 메모리 / RAG | CommitLore | |
주요 질문 | 어떤 오래된 텍스트가 관련 있나? | 어떤 결정이 지금 여기에 여전히 적용되나? |
권위 | 메모리 저장소 또는 공급자 | Git |
범위 | 의미적 유사성 | 저장소 경로 |
수명 주기 | 종종 추가 우선 | 활성 · 대체 · 만료 |
신뢰 | 검색된 텍스트 | 지시 · 주장 · 차단 |
캡처 | 대화 또는 노트 저장 | 증거 확인된 결정 기록 |
이식성 | 백엔드 의존 | 일반 Git |
CommitLore는 의도적으로 더 좁습니다. 일반 사용자 메모리 시스템, 대화 아카이브 또는 벡터 데이터베이스 대체가 아닙니다.
증거
질문 | 측정 결과 | 경계 |
등록된 연구에서 클레임 등급 컨텍스트가 재제안을 변경했는가? | CommitLore 사용 시 2.8% (16/580) vs 미사용 시 18.8% (109/579) | 단일 모델, 단일 하네스, 구성된 태스크 |
수명주기 필터링이 측정된 활성 프로젝션에서 폐기된 레코드를 전달했는가? | 폐기된 레코드 0건 | 대체된 레코드가 존재했음; 만료는 적용되지 않음 |
인덱스 조회가 확장 가능한가? | 10만 커밋에서 p50 496ms | 인덱스 없는 폴백은 훨씬 느림 |
인덱스 빌드 시간은 커밋 수가 아닌 레코드 수를 따릅니다: 비용이 큰 패스는 레코드당 한 번 실행되므로, 오랜 이력이지만 레코드가 적게 기록된 저장소는 레코드가 빽빽한 짧은 이력보다 더 빨리 빌드됩니다.
경로 범위(Path scope)가 대규모 이력을 모델에 도달하지 못하게 막는 요소입니다. #167 말뭉치에서 10,002개 레코드 중 단 2개만 도달했습니다:
경로 | 모델에 노출된 레코드 | 관련 레코드 | 모델에 노출된 토큰 |
전체 주입 | 10,002 | 2/2 | 1,004,554 |
top-k 어휘 | 2 | 1/2 | 190 |
CommitLore 경로 범위 | 2 | 2/2 | 335 |
이는 고정된 2개 레코드 예산에서 노출도와 재현율을 측정한 것입니다 — 토큰 비용, 청구 비용, 정확도, 에이전트 동작이 아닙니다. 단일 말뭉치, 단일 쿼리, 단일 고정 임베딩 모델입니다.
에이전트 연구는 보편적인 모델 효과를 입증하지 않습니다. 전달이 모델이 레코드를 읽거나 따랐다는 증거는 아닙니다.
한계, 신뢰 및 개인정보
캡처는 보조적이며 결정적이지 않습니다. 지원되는 스킬은 일반적인 커밋 요청을 고려하지만, 어떤 호스트도 모든 적격 커밋을 평가하도록 인증되지 않았습니다.
기본 지시 모드는 인증이 아닙니다. 커밋 작성자 헤더를 일치시키며, 커밋을 작성할 수 있는 사람은 누구나 해당 헤더를 설정할 수 있습니다 — 따라서 기본 모드의
[directive]는 신원 증명이 아닌 정책 메타데이터입니다. 서명 모드는 추가로 Git의 자체 검증 상태와 저장소 로컬commitlore.trustedSigner허용 목록의 일치를 요구합니다. 서명자 허용 목록이 없거나, 비어 있거나, 읽을 수 없으면 누구도 승인되지 않으므로 해당 모드는 실패 시 닫힘(fail closed) 방식으로 동작합니다.가드는 안전망이 아닌 실험적 자문입니다: 417개 결정 말뭉치에서 정밀도 44.8% (95% Wilson CI 32.7%–57.5%), 재현율 22.0%. 가드 결과가 비어 있다고 해서 안전 판정은 아닙니다.
전달은 일치하는 모든 도구 호출에서 토큰을 소비합니다. 사전 편집 훅은
Edit,Write,MultiEdit,NotebookEdit뿐만 아니라Read에서도 실행되므로, 편집 에이전트가 커밋하는 것보다 훨씬 자주 실행됩니다. 각 실행은 페이로드 예산(기본 800토큰,--budget으로 변경)까지 소비합니다. 레코드가 없는 저장소는 아무것도 소비하지 않으며, 이는 설치가 아닌 도입과 함께 발생하는 비용임을 의미합니다.답변은 부분적일 수 있습니다. 적용 범위는 공개됩니다. 부분 결과에서 누락된 것이 레코드가 존재하지 않는다는 증거는 아닙니다. 저장소 전체 적용 범위, 심볼 앵커, 대화형 레코드 빌더는 여전히 미해결 과제입니다: #32, #33.
커밋 트레일러는 클론과 함께 이동하지만, 노트는 그렇지 않습니다. Git은 기본적으로
refs/notes/*를 가져오지 않으므로,refs/notes/commitlore의 레코드는commitlore init이 해당 미러를 구성하기 전까지 일반 클론에는 존재하지 않습니다.호스팅 백엔드는 없습니다. 그러나 서버나 훅이 컨텍스트를 반환하면, 호스트는 자체 정책에 따라 해당 컨텍스트를 처리합니다. CommitLore는 해당 데이터 흐름을 제어하지 않습니다.
레코드는 등급이 매겨질 때까지 신뢰할 수 없습니다. 기본 작성자 일치는 정책 메타데이터이지 인증이 아닙니다. 서명 지시 모드는 Git 검증과 저장소 로컬 서명자 허용 목록을 요구합니다. 허용 목록이 없거나 읽을 수 없으면 누구도 승인되지 않습니다. 주입 형태의 페이로드는 모델이 읽을 수 있는 경로에서 차단됩니다.
CLI 설치 프로그램은 알 수 없는 저장소 내부의 훅을 다시 작성할 수 없으며, 실행
중인 호스트 세션은 로드한 런타임을 유지합니다. commitlore doctor는 두 상태와
그 복구 방법을 명시하고, commitlore upgrade는 최신 릴리스가 존재하는지
보고합니다.
레코드는 일반적인 Git 트레일러 또는 노트입니다. 프로토콜 2.0은 수명주기, 신뢰 등급, 검증 및 호환성을 정의합니다.
저장소는 방법론, 제외 기준, 실패한 측정, 그리고 원래 벤치마크나 진단이 틀렸던 사례를 공개합니다.
문서
기여
CONTRIBUTING.md는 이 저장소가 스스로 지키는 레코드 프로토콜, 릴리스 게이트, 그리고 증거를 재현하는 방법을 다룹니다.
라이선스
MIT — LICENSE 참조.
Available Tools
8 toolscommitlore_before_changeARead-only
Everything recorded about a path, before editing it: the active decisions, the gaps in what could be verified, and any ruled-out alternative a proposal would revive. Returns active_decisions, verification_gaps, possible_revival_matches, guard_confidence and cache_key. Pass path alone for context. Pass proposal as well to also run the guard against that path's Ruled-out records; without it guard_confidence is "not-run" and possible_revival_matches is empty because nothing was checked, not because nothing matched. The guard is an experimental advisory: precision 44.8%, recall 22.0% on the 417-decision corpus. An empty possible_revival_matches does not guarantee the proposal avoids every ruled-out alternative.
Inputs: path (required), proposal.
commitlore_guardARead-only
Check a proposal against the Ruled-out records for a path before acting on it. Returns every record whose alternative matches, with the reason it was rejected. Experimental advisory: precision 44.8%, recall 22.0% on the 417-decision corpus. An empty matched array does not guarantee the proposal avoids every ruled-out alternative.
Inputs: proposal (required), path.
commitlore_prepare_captureA
Prepare a capture transaction: computes binding conditions (HEAD, staged diff, tree, policy hash), generates the prompt contract for the agent to use, and persists a phase:"prepared" pending transaction. Returns the nonce needed for verify and stage. The prompt carries the end of the transcript rather than all of it; transcript_window says which lines, numbered as the whole transcript numbers them. Verification still reads the whole transcript, so quote only what the prompt shows you. The transaction binds to THIS server's checkout, returned as repository; if your working directory is a linked worktree or another clone, pass repository to assert it and this refuses rather than binding to the wrong HEAD.
Inputs: transcript (required), repository, unattended.
commitlore_queryARead-only
Active CommitLore records for a path: the constraints, ruled-out alternatives and warnings recorded in git history. Same answer as commitlore <kind> --json.
Inputs: kind (required), path.
commitlore_runtime_identityARead-only
Report the exact CommitLore entrypoint, package root, version and index schema this MCP server executes.
Inputs: no named parameters.
commitlore_stage_captureA
Stage a verified capture transaction: advances the pending record from verified to staged, stamps expires_at (staged_at + 5 minutes), and makes it eligible for the prepare-commit-msg hook. All bindings are server-owned and computed from stored state; the only inputs are the nonce and, optionally, the receipt your verification was issued.
Inputs: nonce (required), receipt.
commitlore_staleARead-only
Records that are no longer carrying their weight: superseded, past a date-form Expires:, or flagged for review by a condition-form one. Same answer as commitlore stale --json.
Inputs: no named parameters.
commitlore_verify_captureA
Verify a capture draft against the transcript and diff that were hashed at prepare time. Evidence citations are checked mechanically (verbatim match); fabricated quotes are discarded. Stores the verified result in the pending transaction for stage to consume.
Inputs: draft (required), nonce (required), transcript (required), diff.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
The capture lifecycle tools (prepare/verify/stage) are clearly separated by phase, and stale/runtime_identity are distinct. However, before_change, query, and guard overlap: before_change already runs the guard when a proposal is supplied, and query also returns ruled-out alternatives for a path. The descriptions help, but an agent could easily pick the wrong one for a pre-edit context lookup.
All tools share the commitlore_ prefix and use lowercase snake_case, which is a clear and consistent pattern. The capture tools use verb_noun (prepare_capture, verify_capture, stage_capture), but before_change, stale, and runtime_identity are stylistic deviations, so the set is mostly consistent rather than fully uniform.
Eight tools is well-scoped for this server's purpose: three for the capture pipeline, three for reading/guarding context, plus stale and runtime identity. Each tool has a place and the set feels neither bloated nor thin.
The core workflow is covered: retrieving records/context, checking proposals, and the prepare/verify/stage capture pipeline. Minor gaps exist—such as no direct way to update, dismiss, or resolve stale records—but these are workable and may be intentionally outside the MCP surface.
Maintenance
Related MCP Connectors
One memory for every AI you work with: your rules, notes and decisions in your own Git repo.
Shared project memory for coding agents: decisions, lessons, guardrails and tasks per repository.
Long-term, rotatable project memory and pre-write checks for AI coding agents.
Project memory for coding agents: requirements, decisions, code graph and delivery telemetry.
Related MCP Servers
- AlicenseAqualityAmaintenanceLocal-first memory layer for AI coding agents — captures issues, attempts, fixes, and decisions, and warns at git commit before you repeat a mistake.19978 PyPI877MIT
- AlicenseAqualityDmaintenanceLocal-first project memory for AI coding agents. Records failed attempts, fragile files, and decisions per repo, and warns the agent via hooks before it repeats a recorded mistake.659 npmMIT
- AlicenseNot gradedqualityCmaintenanceProvides AI coding agents with git-native persistent memory and a dependency-aware task graph, letting them record and fuzzy-recall architectural decisions, lessons, and gotchas while creating, claiming, and completing tasks that auto-unblock downstream work. Stores everything as plain JSON and Markdown committed inside the repository, so context stays branch-aware, team-shared, and reviewable in pull requests.6 npmMIT
- AlicenseBqualityBmaintenanceEnables coding agents to persist and retrieve ADR-style decisions and machine-checkable constraints as git-friendly markdown in a repository, linked to requirement ids, tests and commits. Agents can pull relevant context before a task, check a proposed change against accepted constraints before committing, and record, supersede or search decisions over a local stdio connection.723 npmMIT