Time Machine: 모든 도구 호출을 담는 Claude Code 타임라인

Time Machine은 YeonwooSung(my-claude-code-mods)이 만든 커뮤니티 모드로, 각 Claude Code 세션에 Claude Code 타임라인을 제공합니다. 에이전트가 여러 파일을 고쳤는데 엉뚱한 상태가 되었을 때, git diff는 무엇이 바뀌었는지만 알려 줍니다. Time Machine은 어떤 도구 호출이 어떤 순서로 실행되었고 그 뒤 파일이 어떤 모습이었는지를 기록하므로, 어느 단계로든 돌아갈 수 있습니다.

모든 기능은 /tm 명령 하나로 사용합니다. /tm은 타임라인을 그리고, /tm show <n>은 한 단계를 보여 주며, /tm diff <a> [b]는 두 단계 시점의 파일을 비교하고, /tm why는 실패한 테스트 실행의 원인일 가능성이 높은 수정을 나열합니다. /tm restore <n>과 /tm branch <n>은 파일을 그 단계의 상태로 되돌리고, /tm compare는 두 브랜치나 세션을 비교하며, /tm rerun <n>은 한 단계를 다시 실행하고, /tm sessions는 기록된 세션을 나열합니다. /tm-pane은 실시간 타임라인 패널을 열고, 상태 표시줄에는 tm ② · 1 snaps · 79ms 같은 내용이 나타납니다.

파일을 복원하고 도구를 다시 실행할 뿐, 모델의 답변을 재생하지 않으며 대화를 되돌리지도 않습니다.

녹화에서는 작은 데모 프로젝트에서 이 모드를 불러온 Claude Code를 시작하고, 저장 폴더를 임시 폴더로 지정합니다. Claude에게 프로젝트를 한 줄로 설명하는 NOTES.md를 만들어 달라고 요청합니다. Claude가 README.md를 읽고 파일을 쓰는 동안 상태 표시줄이 tm ⓪에서 tm ②로 올라가고 1 snaps가 표시됩니다. 이어서 /tm을 입력하면 타임라인에 베이스라인 스냅샷(파일 5개), ① Read README.md, 그리고 자체 스냅샷이 있는 ② Write NOTES.md가 나열되며, A NOTES.md는 추가된 파일을 뜻합니다.

설치 블록의 방법 중 아무것이나 사용하세요. 모두 작성자 본인의 마켓플레이스에서 바로 설치합니다. 모드는 다음 세션부터 동작하며, /tm은 세션 시작 시 등록됩니다.

tool.call이 있을 때마다 한 단계를 기록합니다. 파일을 바꾸는 도구(편집, 쓰기, 기본적으로 모든 Bash 호출, 알 수 없는 도구와 MCP 도구) 뒤에는 자체 인덱스를 사용해 작업 트리를 자신의 저장 폴더에 있는 베어 "섀도" 저장소에 커밋하므로 사용자의 .git은 읽거나 쓰지 않습니다. 도구가 실행되기 전에 작업 트리가 마지막 스냅샷 이후 바뀌어 있으면(예: IDE에서 파일을 고친 경우) 에이전트 탓으로 돌리지 않고 external 단계로 기록합니다. 파일을 바꾸는 명령의 보호 로직은 다음과 같으며 hooks/register.tsx에서 가져왔습니다.

// Origins a person typed: the only ones allowed to change files or run commands through /tm.
const TYPED = new Set(['composer', 'bridge', 'sdk'])

const sub = changesFiles(args)
const kind = e.origin?.kind ?? 'unknown'
if (sub !== undefined && !TYPED.has(kind)) return { text: `time-machine: ${sub} changes files or runs commands and only runs when you type it (this came from ${kind})` }

/tm why는 증명이 아니라 추정입니다. 실패한 실행 이전에 같은 테스트 명령이 마지막으로 통과한 실행을 기준으로 삼아, 그 사이에 바뀐 각 파일에 점수를 매기며, 실패 출력에 해당 경로가 나올수록 점수가 높습니다. 테스트 출력은 pytest, jest와 vitest, go, cargo, node:test 형식을 해석하고, 그 밖의 출력은 종료 상태만 사용합니다.

플러그인 설정에는 네 가지 옵션이 있습니다.

• storeDir: 스냅샷과 타임라인이 저장되는 위치로, 프로젝트마다 폴더 하나입니다. 절대 경로이거나 ~/로 시작해야 하고 프로젝트 밖에 있어야 하며, 그렇지 않으면 스냅샷이 꺼집니다. 기본값은 ~/.claude/time-machine입니다.
• retentionDays: 이 일수보다 오래된 세션을 삭제하며, 확인은 하루에 최대 한 번입니다. 기본값은 14이고 0이면 모두 보관합니다.
• recordModelOutput: 기본값은 꺼짐입니다. 켜면 모델의 응답 텍스트와 각 프롬프트의 앞 200자를 저장하고, 끄면 길이와 해시만 저장합니다.
• skipSearchBash: 기본값은 꺼짐입니다. 켜면 검색으로 분류된 Bash 명령(rg, grep, ls, cat) 뒤에는 스냅샷을 찍지 않습니다.

플러그인이 불러오는 모든 파일을 읽었습니다. plugin.json, hooks/hooks.json, hooks/register.tsx, hooks/git.ts, hooks/core/의 모든 파일, 그리고 README와 테스트입니다. package.json, 설치 스크립트, 바이너리, 번들된 코드는 없습니다. fetch, http, child_process, eval, 동적 import(), WebSocket, 폭 없는 문자나 양방향 유니코드 문자를 검색했지만 아무것도 나오지 않았습니다. 눈여겨볼 점은 다음과 같습니다.

• 프로세스를 실행합니다: $.process.run을 통해 git(섀도 저장소 대상)과 mkdir, rm -rf, cp, find -delete, sh를 실행합니다. rm -rf와 find -delete는 저장 폴더 안의 경로로 제한됩니다(register.tsx와 git.ts의 isInside 검사). /tm rerun --isolated --yes는 기록된 Bash 명령을 스냅샷 복사본 안에서 sh -lc로 실행합니다. 샌드박스가 아니며 권한 대화상자도 거치지 않습니다. 사용자가 직접 입력했을 때만 실행되고, 프로젝트의 절대 경로가 들어 있는 명령은 거부합니다.
• 파일을 씁니다: 저장 폴더(기본값 ~/.claude/time-machine) 아래에 씁니다. settings.json, 셸 파일, LaunchAgents, git 훅에는 쓰지 않습니다. /tm restore --yes는 프로젝트의 추적 파일을 다시 쓰지만, 사용자가 입력했을 때만, 복원 전 스냅샷을 저장한 뒤에 실행되며, 무시된 파일을 덮어쓰게 되면 거부합니다.
• 작업 내용을 기록합니다: 스냅샷에는 무시되지 않은 파일의 전체 내용이 들어가므로 프로젝트에 둔 비밀 값도 포함됩니다. 도구 입력과 결과는 최선의 노력으로 마스킹되지만 스냅샷 속 파일 내용은 마스킹되지 않습니다. 저장 폴더를 공유하기 전에 확인하세요.
• 대화에 텍스트를 넣는 것은 한 번뿐입니다. 복원 후에 파일이 복원되었고 이전 도구 결과가 오래되었다는 메모를 덧붙입니다. 그 밖에는 프롬프트나 도구 결과를 고쳐 쓰지 않습니다.
• 모든 도구 호출을 감쌉니다(.catch가 있는 tool.call 게이팅 훅). 거부를 포함해 답을 그대로 전달하며, 기록 오류가 도구를 막지 않습니다. 병렬로 실행되는 변경 호출은 외부 변경 검사가 끝나기를 기다립니다.
• 네트워크, 데몬, 텔레메트리는 없습니다. 정리 작업은 시작 후 분리되어 실행되지만 세션과 함께 끝납니다. 읽는 환경 변수는 HOME뿐입니다.
• 외부 요구 사항: git이 설치되어 있어야 합니다. 세션 루트가 홈 폴더 또는 /이면 스냅샷이 꺼집니다.
• 라이선스: Apache-2.0(저장소 루트에 LICENSE 파일 있음)이며 재배포를 허용합니다.

claude plugin validate는 오류와 경고를 보고하지 않았습니다. 작성자의 테스트는 Claude Code 2.1.303에서 103개 통과, 0개 실패였습니다.

macOS의 Claude Code 2.1.303에서 확인했습니다(validate, 작성자의 테스트, 데모 녹화). 작성자는 Claude Code 2.1.287 이상을 안내합니다. 이상이 있다면 다음을 확인하세요.

• 상태 표시줄에 snapshots off가 보임: /tm을 실행하면 맨 위에 이유가 나옵니다. 흔한 원인은 세션 루트가 홈 폴더인 경우, storeDir가 상대 경로이거나 프로젝트 안에 있는 경우, git이 없는 경우, 베이스라인 스냅샷이 5초 넘게 걸린 경우입니다.
• 큰 저장소에서는 변경 도구마다 스냅샷 시간이 듭니다. 평균은 상태 표시줄에 표시됩니다.
• 프로젝트 안에서 계속 바뀌는 로그 파일이 있으면 변경 도구 앞마다 external 단계가 생깁니다.
• 무시된 파일(빌드 산출물, node_modules, .env)은 스냅샷도 복원도 되지 않습니다.
• 패널과 상태 표시줄은 터미널에서 보입니다. VS Code 채팅 패널에서는 명령만 동작합니다.