kechup은 프로젝트 폴더 하나에서 AI 에이전트와 운영자가 작업을 추적하도록 돕는 명령줄 도구다. 작업 상태와 메모, 담당 기록을 프로젝트 폴더와 Git에 저장해 다음 세션이 이전 진행 상황을 확인할 수 있게 한다.

keche.md의 Work 섹션에는 진행 중·차단·할 일·완료 상태가 표시되고, .kechup/tasks.json에는 작업이 저장된다. kechup이 기록하는 변경은 각각 에이전트 ID를 작성자로 삼은 Git 커밋이 된다. 작업을 완료 처리하려면 결과를 담은 REPORT.md를 커밋해야 한다. 상태만 바꾸는 것으로는 작업을 닫을 수 없다.

에이전트는 kechup next --claim으로 열려 있고 선행 작업에 막히지 않은 작업을 가져온다. 두 에이전트가 같은 작업을 맡지 못하도록 잠금 기능도 제공한다. 일반적인 git revert로 완료된 작업을 되돌리면 kechup은 다음에 작업을 읽을 때 이를 감지하고, 해당 작업에 의존하는 작업도 다시 차단 상태로 표시한다.

설치에는 Python 3.12 이상과 Git이 필요하며 Linux와 macOS를 지원한다. Windows는 fcntl 파일 잠금 기능을 사용하기 때문에 지원하지 않는다. Python 표준 라이브러리와 git 명령만 사용하며 서버·데이터베이스·계정·네트워크 연결·API 키는 필요하지 않다. 설치는 pip install kechup 또는 pipx install kechup으로 할 수 있다.

사용하려면 에이전트의 지침 파일에 kechup 사용 방법을 적거나, 저장소의 skills/kechup/SKILL.md를 에이전트의 스킬 폴더에 복사해야 한다. 모든 쓰기 명령에는 --by <id>로 에이전트 ID를 전달해야 하며, KECHUP_AGENT 환경 변수로 지정할 수도 있다. ID가 없으면 쓰기 명령은 종료 코드 3으로 중단된다.

kechup은 작업 결과의 품질을 판단하거나 에이전트를 실행·예약·연결하지 않으며, 여러 기기 간 동기화도 제공하지 않는다. done 명령은 REPORT.md가 존재하고 커밋됐는지만 확인한다. 시각적인 작업 보드나 기기 간 동기화, AI가 작업을 작성해 주는 기능이 필요하다면 다른 도구를 사용하라고 프로젝트 문서는 안내한다.