세션이 끝나도
작업 상태는 남습니다
Worktrail은 AI 세션 사이에서 결정·제약·근거·열린 문제·다음 행동을 이어 줍니다. 새 세션은 지난 대화를 다시 해석하지 않고, 지금도 유효한 작업 상태에서 바로 시작합니다.
가입 없이 보는 읽기 전용 데모입니다. 기록은 가상의 팀이 쓴 것입니다.
대화를 통째로 보관하거나 모든 것을 기억하는 AI 메모리가 아닙니다. 에이전트가 일하면서 남긴 것 가운데 다음 사람이 이어받아야 할 것만 따로 둡니다.
세션이 바뀔 때 무엇이 남는지 직접 넘겨 보기
예시는 데모에 있는 가상 팀의 스레드 #6에서 가져왔습니다.
Worktrail 이 일하는 모습
영상 속 저장소와 기록은 데모의 가상 팀 것입니다. 터미널의 도구 응답과 오른쪽 화면은 그 데모 위에서 실제로 돌린 것입니다.
실제로 써 본 화면 · 약 2분 · 실제 녹화, 기다림만 빨리 감음
과거를 다시 읽는 대신, 멈춘 자리에서 이어 갑니다
코드와 커밋에는 무엇을 바꿨는지만 남습니다. 왜 그렇게 정했는지, 무엇이 아직 안 풀렸는지, 다음이 누구 차례인지는 남지 않습니다.
새 세션은 지난 세션을 모릅니다
- 코드, diff, 커밋 메시지를 다시 읽습니다.
- 지난번에 무엇을 정했고 왜 그랬는지 거기서 짐작합니다.
- 이미 버린 방법을 다시 꺼내거나, 끝난 일을 또 할 수 있습니다.
- 사람이 지난 대화를 요약해 다시 붙여 넣습니다.
세션이 바뀔 때마다 같은 해석을 처음부터 되풀이합니다.
새 세션이 지금 유효한 상태를 먼저 받습니다
- Claude Code는 세션을 시작할 때 이 작업폴더에서 무엇을 하던 중이었는지를 먼저 띄웁니다. 스레드의 초점, 안 풀린 것, 다음 행동.
- 거기서 이어 가려면
resume한 번. 제약과 결정, 근거가 된 원문, 지금 git 위치까지 일곱 칸이 옵니다. - 결정에는 이유와 누가 정했는지가, 결론에는 근거가 된 원문이 붙어 있습니다.
- 다음 행동에서 바로 시작하고, 새로 알게 된 것은 그 자리에 다시 남깁니다.
해석이 끝난 상태가 넘어오므로, 새 세션은 거기서 출발합니다.
기억이 아니라, 지금 유효한 작업 상태
일은 스레드 단위로 남습니다. 한 저장소에서 하나의 질문이나 변경을 끝까지 따라가는 단위입니다. 새 세션이 resume으로 받는 것은 아래의 일곱 칸입니다.
이 스레드가 무엇을 위한 것이고, 무엇이 되면 끝나는지.
앞으로 지켜야 할 선. 저장소 전체에 걸리는 것은 그 저장소의 모든 스레드에 같이 나옵니다. 외부 결제 호출을 사용자 요청 안에서 기다리지 않는다
따르기로 한 선택과 그 이유, 사람이 정했는지 에이전트가 정했는지. 옛 결정은 지워지지 않고 새 결정으로 대체됩니다. 결제 대행사는 페이레일로 간다 · 부분취소와 정산 주기가 갈랐다
아직 안 풀린 질문과 막힌 것.
다음에 할 일과 그 차례가 누구인지. 사람, 에이전트, 또는 지켜보기만 할 때. 에이전트는 단계마다 이것을 다시 말해야 합니다.
기계나 사람이 실제로 말한 것. 시험 결과, 에러, diff를 요약하지 않고 원문 그대로 두고 번호로 답니다.
이 작업폴더의 브랜치·HEAD·바뀐 파일, 그리고 스레드에 붙은 커밋.
남기지 않는 것
- 대화 전체. 기록되는 것은 에이전트가 도구로 남긴 것과, 훅이 붙이는 커밋·작업폴더 위치뿐입니다.
- 에이전트의 추측. 뒤집힐 수 있는 가설은 노트에 머물고,
resume에는 나오지 않습니다. - 코드 자체. 코드는 git에 있습니다. Worktrail은 코드 주변의 맥락을 남깁니다.
규칙은 서버가 지킵니다
- 주제 없이는 스레드를 열 수 없습니다.
- 다음 행동과 그 차례를 적지 않으면 단계를 남길 수 없습니다.
- 모든 글의 첫 줄은 제목이고, 120칸을 넘으면 거절됩니다.
현황은 지금을, 회고는 거기까지 온 길을 보여 줍니다
같은 기록을 두 방향에서 읽습니다. 아래는 데모에 있는 가상 팀의 주제 하나입니다.
무엇이 열려 있고, 다음은 누구 차례인가
열린 스레드마다 에이전트가 마지막으로 선언한 다음 행동과 그 차례가 한 줄로 보입니다. 사람이 움직일 것, 에이전트에게 넘긴 것, 아직 아무도 정하지 않은 것이 나뉩니다. 옆의 Now 띠에는 최근 기록이 방향(결정·제약·선언)과 흔적(노트·증거·커밋)으로 나뉘어 쌓입니다.
페이레일로 옮겼고 실결제 전환만 남았다
부분취소를 API로 열어 주는 곳이 둘뿐이었고 정산이 D+2라 페이레일로 정했다. 샌드박스는 결제·부분취소·웹훅까지 통과했다.
- 제약대행사를 부르는 코드는 어댑터 뒤에만 둔다이번이 두 번째 교체다
- 결정결제 대행사는 페이레일로 간다부분취소와 정산 주기가 갈랐다
- 종료샌드박스에서 결제·부분취소·웹훅이 통과했다
- 열림실결제 키로 첫 한 건을 태우기 전에 점검한다
지금의 상태가 어떻게 만들어졌나
주제마다 결론이 맨 위에 있고, 그 아래로 어떤 제약과 결정을 거쳐 여기까지 왔는지, 어떤 스레드가 닫히고 무엇이 남았는지가 보입니다. 결정을 누르면 그 이유와 근거가 된 원문으로 갑니다.
기록을 어디에 둘지 고르고, 쓰는 에이전트에 붙입니다
맥·리눅스·WSL에서 동작합니다. 윈도우에서는 신청 화면이 주는 지시문을 코딩 에이전트에게 붙여 넣으면 에이전트가 설치합니다.
이 컴퓨터에만
신청 없이 바로기록이 이 컴퓨터의 sqlite 파일 하나(~/.casebook/casebook.db)에 남습니다. 설치가 끝나면 아무것도 밖으로 나가지 않습니다.
- 회사 코드·비밀이 섞인 작업도 그대로 기록할 수 있습니다.
- 네트워크나 계정 없이 동작합니다.
- 기계가 여러 대면 기록이 따로 놉니다. 백업은 직접 합니다.
- claude.ai 커넥터로는 못 붙입니다.
호스팅 서버에
신청 필요기록이 운영 서버에 남고, 설치 한 줄로 받은 URL이 열쇠가 됩니다. 구글 로그인과 데이터 안내문 동의를 거칩니다.
- 맥·리눅스 여러 대, 에이전트를 섞어 써도 같은 기록을 봅니다.
- claude.ai 커넥터로 붙습니다. 고친 것이 재설치 없이 닿습니다.
- 한 서버 한 DB라 운영자는 기록을 볼 수 있습니다.
- 자리가 정해져 있어 승인을 기다릴 수 있습니다.
Claude Code
플러그인 두 줄이면 MCP 등록과 세션 훅까지 끝납니다. 신청은 필요 없고, Python 3.11 이상 또는 uv가 있으면 됩니다.
/plugin marketplace add jasonethicseo/worktrail /plugin install worktrail@worktrail
Claude Code 안에서 실행합니다. 새 버전을 자동으로 받으려면 auto-update를 켭니다. 설치 안내 →
신청 화면에서 서버를 고르면 설치 한 줄을 받습니다. 그 줄이 클라이언트 설치, MCP 등록, 훅까지 한 번에 합니다.
curl -fsSL <받은 URL>/install.sh | sh -s -- --server
URL이 곧 열쇠입니다. 화면 공유나 채팅에 올리지 않습니다.
세션을 시작하면 이 작업폴더의 열린 스레드가 저절로 뜹니다. 커밋도 저절로 붙습니다.
Codex CLI
플러그인이 없으므로 소스에서 깔고 직접 등록합니다. 신청은 필요 없습니다.
git clone https://github.com/jasonethicseo/worktrail.git && cd worktrail python3 -m venv .venv && .venv/bin/pip install -e ".[mcp]" mkdir -p ~/.casebook && echo local > ~/.casebook/mode codex mcp add casebook -- $PWD/.venv/bin/python -m casebook.adapters.mcp_proxy
기록은 ~/.casebook/casebook.db에 남습니다. 자리를 옮기려면 CASEBOOK_DB를 줍니다.
같은 설치 한 줄입니다. codex가 깔려 있으면 알아서 등록하고, 첫 연결이 끊기지 않게 Codex의 시작 대기를 30초로 올립니다.
curl -fsSL <받은 URL>/install.sh | sh -s -- --server
Claude Code와 Codex가 둘 다 있으면 한 줄로 둘 다 등록됩니다.
Codex에는 세션 훅이 없습니다. 세션을 열고 한 번 casebook 열린 스레드 보여줘
라고 하면 그 세션 내내 알아서 기록합니다. 그 한마디도 빼려면 ~/.codex/AGENTS.md에 적어 둡니다. 터미널 커밋을 붙이려면 저장소마다 한 번 sh tools/hooks/install_git_hook.sh.
설치한 뒤 어떻게 쓰는지는 사용 문서에 있습니다.