매번 AI 도구에 코드베이스를 다시 설명하는 것이 지겨워져서 Checkpoint를 만들었습니다

Claude, Codex, 그리고 Claude Code 사이를 전환할 때마다, 저는 세션의 첫 몇 분을 똑같은 내용—무엇을 만들고 있는지, 현재 작업이 무엇인지, 이미 어떤 결정이 내려졌는지—을 다시 설명하는 데 소비했습니다.

도구들은 서로 메모리(Memory)를 공유하지 않습니다. 제가 바로 컨텍스트 버스(context bus)였습니다.

그래서 저는 여러분의 레포지토리(repo)에 연속성 계층(continuity layer)을 제공하는 로컬 CLI인 Checkpoint를 만들었습니다. (프로젝트 이름은 contextos이며, 실제로 입력하는 명령어는 checkpoint입니다.) 이 도구는 .contextos/ 디렉토리에 읽기 쉬운 Markdown 파일을 작성하고, 다음 AI 도구를 위한 집중된 연속성 팩(continuation pack)을 생성합니다:

checkpoint continue --from codex --for claude-code

출력물은 현재 작업, 관련 결정 사항, 검토해야 할 파일, 다음 작업이 포함된 압축된 Markdown 핸드오프(handoff)입니다. 이를 복사하여 붙여넣거나 다음 에이전트(agent)로 파이프(pipe) 연결하면 됩니다.

실제 팩은 다음과 같이 생겼습니다 (예시 — 실제 출력물로 교체하세요):

# Continuation Pack — for Claude Code
Generated from: codex · 2026-06-02

...

설치 (Install)

pip install checkpoint-cli

또는 uv를 사용하여:

uv tool install checkpoint-cli

60초 만에 시작하기

checkpoint setup-user   # 일회성 사용자 설정
checkpoint init         # 프로젝트에 .contextos/ 추가
checkpoint status       # 존재하는 메모리 확인
...

작동 원리

모든 것은 여러분이 읽고, 편집하고, 차이점(diff)을 확인하고, 커밋(commit)할 수 있는 일반 Markdown 파일로 저장됩니다:

.contextos/
  context/        # 아키텍처(architecture), 제약 사항(constraints), 결정 사항(decisions)
  tasks/          # 진행 중이거나 완료된 작업(active and completed work)
...

checkpoint continue는 이 파일들을 읽고, 비밀 정보 비식별화(redaction)를 적용한 뒤, 대상 에이전트—Codex, Claude, Claude Code, Cursor, Aider 또는 일반(generic) 형태—에 맞춰 구성된 팩을 출력합니다.

계정 필요 없음. 클라우드 사용 안 함. 숨겨진 상태(hidden state) 없음. Apache-2.0 라이선스.

로컬 우선(local-first)이 중요한 이유

어떤 컨텍스트를 다음 도구로 넘길지는 여러분이 결정합니다. 파일은 여러분의 소유입니다. 어디로 전송되기 전에 읽을 수 있으며, 전송 과정에서 비밀 정보는 비식별화됩니다.

현재 상태

v0.1.3. 작동하며, 자체 테스트(dogfooding)를 거쳤으나 일부 미흡한 부분이 있습니다. 사용 중 문제가 발생하면 이슈(issue)를 생성해 주세요. 그리고 다음에 어떤 에이전트 형식(agent format)을 지원하길 원하는지도 알려주세요.

• GitHub의 ContextOs
• 사이트 및 빠른 시작(quickstart)
• PyPI의 checkpoint-cli