Claude Replay

Name: Claude Replay
Author: constripacity

โดย constripacityรุ่น 0.4.3i★ 1iรันบนเครื่อง

ชื่อใน registryio.github.constripacity/claude-replay

วิธีติดตั้ง

ภาพรวม

คำอธิบายจากผู้ทำ (ภาษาอังกฤษตามต้นฉบับ)

Session checkpoint & recovery for Claude Code: resume, search, tag, and export recorded sessions.

สามเสาของ PopNx MCP

เสียงผู้ใช้iยังไม่มีรีวิว
ผลตรวจเบื้องต้นของเราiผ่าน 3 จาก 3 ข้อ
การใช้งานiยังใหม่มาก

พูดคุย

ถาม แชร์เคล็ดลับ หรือบอกว่าใช้ไม่ได้ · คนใช้ AI ตัวเดียวกันช่วยกันตอบ

ต้องใช้คีย์ไหม ใช้กับ ChatGPT ได้ไหม ฟรีไหม

ถามหรือแชร์อะไรเกี่ยวกับ Claude Replay…โพสต์

ต้องเข้าด้วย Google ก่อนโพสต์ · เราแสดงแค่ชื่อที่คุณตั้ง

ยังไม่มีใครถามเรื่อง Claude Replay

เป็นคนแรกได้เลย หรือแตะคำถามที่มือใหม่ถามบ่อย

ใช้ทำอะไรได้

ตัวนี้ยังไม่ได้เรียบเรียงเป็นภาษาไทย ด้านล่างคือข้อเท็จจริงที่เราอ่านจาก registry

การเชื่อมต่อ: รันบนเครื่อง
ช่องทาง (transport): stdio
หมวด: เอกสาร ตาราง และงานออฟฟิศ

ติดตั้ง

เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง

ผลตรวจผ่าน 3/3 · ทำงานบนเครื่องคุณ

ขั้นแรก: คุณใช้ AI ตัวไหน

Claudeเว็บ · แอป · มือถือChatGPTเว็บClaude CodeTerminalCursorโปรแกรมเขียนโค้ดVS Codeโปรแกรมเขียนโค้ดอื่น ๆโปรแกรมอื่น

เลือกแอปที่คุณใช้ ขั้นตอนจะขึ้นด้านล่าง

ต่อกับ Claude ได้ แต่ต้องเตรียมก่อน

ต้องมีคีย์ของ Claude Replay (สมัครที่เว็บของผู้ทำ อาจมีค่าใช้จ่าย) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว) · ใช้ได้เฉพาะแอป Claude บนคอม (Windows หรือ Mac) ไม่ใช่บนเว็บหรือมือถือ

ลง Python (uv) ในเครื่อง
ทำครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ Python (uv)
เปิดหน้าดาวน์โหลด Python (uv) ↗
ทำแล้ว
สมัครและสร้างคีย์ของ Claude Replay
เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป อาจมีค่าใช้จ่าย
วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง
ทำแล้ว
เปิดไฟล์ตั้งค่าของแอป Claude บนคอม
SettingsDeveloperEdit Config
ทำแล้ว
4
วางค่าตั้งนี้แล้วบันทึกไฟล์
```
{
  "mcpServers": {
    "claude-replay": {
      "command": "uvx",
      "args": [
        "claude-replay",
        "mcp"
      ],
      "env": {
        "CLAUDE_REPLAY_DB": "ใส่ค่าของคุณ"
      }
    }
  }
}
```
วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร
ทำแล้ว
ปิดแอป Claude แล้วเปิดใหม่
ทำแล้ว
ลองเลย
ใช้ Claude Replay บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง
✓ ถ้า Claude บอกว่ากำลังใช้ Claude Replay หรือมีชื่อเครื่องมือของ Claude Replay ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ChatGPT ยังต่อ Claude Replay ไม่ได้

Claude Replay ต้องติดตั้งในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะตัวที่ทำงานบนเว็บ

คุณทำแบบนี้แทนได้

ก · ใช้แอปที่ต่อ Claude Replay ได้

ดูขั้นตอนสำหรับ Claude →ต้องมีคีย์ของ Claude Replay (สมัครที่เว็บของผู้ทำ อาจมีค่าใช้จ่าย) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว) · ใช้ได้เฉพาะแอป Claude บนคอม (Windows หรือ Mac) ไม่ใช่บนเว็บหรือมือถือ
ดูขั้นตอนสำหรับ Claude Code →ต้องมีคีย์ของ Claude Replay (สมัครที่เว็บของผู้ทำ อาจมีค่าใช้จ่าย) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)
ดูขั้นตอนสำหรับ Cursor →ต้องมีคีย์ของ Claude Replay (สมัครที่เว็บของผู้ทำ อาจมีค่าใช้จ่าย) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)
ดูขั้นตอนสำหรับ VS Code →ต้องมีคีย์ของ Claude Replay (สมัครที่เว็บของผู้ทำ อาจมีค่าใช้จ่าย) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)

ข · ตัวอื่นในหมวด เอกสาร ตาราง และงานออฟฟิศ ที่ต่อกับ ChatGPT ได้

เลือกจากตัวที่ใช้มากในหมวดเดียวกัน เฉพาะตัวที่ต่อด้วยที่อยู่ได้โดยไม่ต้องใส่คีย์

Puter MCP✓ ChatGPT
LMCP✓ ChatGPT
Keeper.sh✓ ChatGPT

ต่อกับ Claude Code ได้ แต่ต้องเตรียมก่อน

ต้องมีคีย์ของ Claude Replay (สมัครที่เว็บของผู้ทำ อาจมีค่าใช้จ่าย) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)

ลง Python (uv) ในเครื่อง
ทำครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ Python (uv)
เปิดหน้าดาวน์โหลด Python (uv) ↗
ทำแล้ว
สมัครและสร้างคีย์ของ Claude Replay
เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป อาจมีค่าใช้จ่าย
วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง
ทำแล้ว
เปิด Terminal
Mac: กด Command+Space พิมพ์ Terminal · Windows: เปิด PowerShell
ทำแล้ว
4
วางคำสั่งนี้แล้วกด Enter
```
claude mcp add claude-replay --env CLAUDE_REPLAY_DB='ใส่ค่าของคุณ' -- uvx claude-replay mcp
```
แก้ “ใส่ค่าของคุณ” เป็นคีย์ของคุณก่อนกด Enter
วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร
ทำแล้ว
พิมพ์ /mcp ใน Claude Code
ต้องเห็น Claude Replay ในรายการและขึ้นว่าเชื่อมต่อแล้ว
ทำแล้ว
ลองเลย
ใช้ Claude Replay บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง
✓ ถ้า Claude Code บอกว่ากำลังใช้ Claude Replay หรือมีชื่อเครื่องมือของ Claude Replay ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ต่อกับ Cursor ได้ แต่ต้องเตรียมก่อน

ลง Python (uv) ในเครื่อง
ทำครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ Python (uv)
เปิดหน้าดาวน์โหลด Python (uv) ↗
ทำแล้ว
สมัครและสร้างคีย์ของ Claude Replay
เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป อาจมีค่าใช้จ่าย
วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง
ทำแล้ว
กดปุ่มนี้เพื่อเปิด Cursor
เปิดใน Cursor
Cursor จะถามยืนยันการติดตั้ง ให้กด Install
ทำแล้ว
ใส่คีย์ในช่องที่ว่างไว้
ในค่าตั้งของ Claude Replay ช่อง CLAUDE_REPLAY_DB ยังว่าง ใส่คีย์ของคุณแล้วบันทึก
วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร
ทำแล้ว
เปิดแชตของ AI ใน Cursor โหมด Agent
ทำแล้ว
ลองเลย
ใช้ Claude Replay บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง
✓ ถ้า Cursor บอกว่ากำลังใช้ Claude Replay หรือมีชื่อเครื่องมือของ Claude Replay ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Cursor เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ VS Code ได้ แต่ต้องเตรียมก่อน

ลง Python (uv) ในเครื่อง
ทำครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ Python (uv)
เปิดหน้าดาวน์โหลด Python (uv) ↗
ทำแล้ว
สมัครและสร้างคีย์ของ Claude Replay
เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป อาจมีค่าใช้จ่าย
วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง
ทำแล้ว
กดปุ่มนี้เพื่อเปิด VS Code
เปิดใน VS Code
VS Code จะถามยืนยันการติดตั้ง ให้กด Install
ทำแล้ว
ใส่คีย์ในช่องที่ว่างไว้
ในค่าตั้งของ Claude Replay ช่อง CLAUDE_REPLAY_DB ยังว่าง ใส่คีย์ของคุณแล้วบันทึก
วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร
ทำแล้ว
เปิดแชตของ AI ใน VS Code โหมด Agent
ทำแล้ว
ลองเลย
ใช้ Claude Replay บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง
✓ ถ้า VS Code บอกว่ากำลังใช้ Claude Replay หรือมีชื่อเครื่องมือของ Claude Replay ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ VS Code เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

โปรแกรมอื่นที่ใช้ MCP ได้ เช่น Windsurf, Zed หรือ Gemini CLI มีวิธีเพิ่มต่างกัน ดูวิธีของแต่ละตัวในหน้ารวมโปรแกรม

ดูโปรแกรมที่ใช้ MCP ทั้งหมด →

ค่าตั้งแบบไฟล์ JSON อยู่ในหัวข้อ “สำหรับคนเขียนโค้ด” ด้านล่าง

ติดตรงไหน? ถามคนที่ใช้ Claude Replay อยู่💬 พูดคุย →

สำหรับคนเขียนโค้ด: คำสั่ง Terminal และค่าตั้ง JSON

ติดตั้งในเครื่อง

Claude Code

claude mcp add claude-replay --env CLAUDE_REPLAY_DB='ใส่ค่าของคุณ' -- uvx claude-replay mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "claude-replay": {
      "command": "uvx",
      "args": [
        "claude-replay",
        "mcp"
      ],
      "env": {
        "CLAUDE_REPLAY_DB": "ใส่ค่าของคุณ"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "claude-replay": {
      "command": "uvx",
      "args": [
        "claude-replay",
        "mcp"
      ],
      "env": {
        "CLAUDE_REPLAY_DB": "ใส่ค่าของคุณ"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "claude-replay": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "claude-replay",
        "mcp"
      ],
      "env": {
        "CLAUDE_REPLAY_DB": "ใส่ค่าของคุณ"
      }
    }
  }
}

ค่าที่ต้องใส่เอง

CLAUDE_REPLAY_DB env
SQLite database path (default: ~/.claude-replay/sessions.db). Point HTTP and stdio instances at the same path to share recorded sessions.

ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README

สรุป

ดาว GitHub i: 1
ดาวน์โหลดต่อสัปดาห์i: 59/สัปดาห์
license i: MIT
การเชื่อมต่อ: รันบนเครื่อง
ช่องทาง (transport): stdio
รุ่นล่าสุดi: 0.4.3
หมวดi: เอกสาร ตาราง และงานออฟฟิศ
ส่งเข้า registryi: 18 ส.ค. 2569
แก้โค้ดล่าสุดi: 24 ส.ค. 2569
ผู้ทำ: constripacity
แพ็กเกจ: pypi: claude-replay
repo: constripacity/Claude-Replay
สถานะใน registry: ใช้งานอยู่

ใช้กับโปรแกรมไหนได้

ดูจากแบบการต่อของ server ตัวนี้ และเอกสารของผู้ทำโปรแกรมแต่ละตัว ตรวจเมื่อ 10 พ.ย. 2569

ติดตั้งบนเครื่องได้ใน

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

ดูโปรแกรมทั้งหมดพร้อมข้อดีข้อเสีย →

คู่มือที่เกี่ยวข้อง

เรื่องที่ 8เช็ก 5 ข้อก่อนติดตั้ง MCP ไม่ให้ข้อมูลรั่วใช้เวลาราว 2 นาทีต่อตัว ดูจากหน้าของตัวนั้นบนเว็บเรา และหน้าขออนุญาตของโปรแกรม AI ก่อนกดยอมอ่าน 4 นาที

ทำอะไรได้บ้าง

รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง

ผลตรวจเบื้องต้นi

เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 11 พ.ย. 2569

✓ ผ่าน
ตัวตนผู้ทำตรงกับ repo
ชื่อใน registry ยืนยันด้วยบัญชี GitHub constripacity ซึ่งเป็นเจ้าของ repo
✓ ผ่าน
ยังมีคนดูแล
มีการแก้โค้ดล่าสุด 3 เดือนที่ผ่านมา
✓ ผ่าน
มีสัญญาอนุญาต (license)
ใช้ MIT
– ไม่เกี่ยว
endpoint ตอบ
ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต
– ไม่เกี่ยว
ล็อกอินแบบ OAuth
ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน
… ยังไม่ตรวจ
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต

พูดคุย

ถาม แชร์เคล็ดลับ หรือแจ้งว่าใช้ไม่ได้ เรียงตามที่คนกดว่ามีประโยชน์

ยังไม่มีใครโพสต์ ถามหรือแชร์เป็นคนแรกได้เลย

ข้อความในส่วนนี้เขียนโดยผู้ใช้ ไม่ใช่ทีม PopNx

เข้าสู่ระบบด้วย Google เพื่อโพสต์

รีวิวจากผู้ใช้

ยังไม่มีรีวิว

เข้าสู่ระบบด้วย Google เพื่อเขียนรีวิว

เทียบกับตัวอื่นในหมวด เอกสาร ตาราง และงานออฟฟิศi

ดาวมากกว่า 80% ของอีก 3758 ตัวในหมวดนี้
ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 25% ของอีก 3758 ตัวในหมวดนี้
ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 100% ของอีก 3758 ตัวในหมวดนี้

เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo

คำถามที่พบบ่อย

Claude Replay ปลอดภัยไหม?

จากการตรวจเบื้องต้นของเรา ผ่าน 3 จาก 3 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น

ต้องใช้กุญแจหรือรหัสอะไรบ้าง?

registry ไม่ได้ระบุว่าต้องใช้กุญแจ แต่บางตัวจะขอให้ล็อกอินตอนใช้ครั้งแรก

ตัวนี้รันบนเครื่องหรือบนคลาวด์?

รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)

ยังมีคนดูแลอยู่ไหม?

repo บน GitHub มีการแก้โค้ดล่าสุด 3 เดือนที่ผ่านมา และส่งรุ่นล่าสุด (0.4.3) เข้า registry 3 เดือนที่ผ่านมา

ใช้กับโปรแกรมไหนได้บ้าง?

โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี Python (uv) ในเครื่องด้วย

มีตัวไหนใช้แทนได้บ้าง?

ในหมวดเดียวกันมี Puter MCP, XcodeBuildMCP, XcodeBuildMCP

ตัวที่ใช้แทนได้

server หมวดเดียวกันจากผู้ทำคนอื่น เรียงตามดาว

อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi

Puter MCP

Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more

โดย HeyPuterใช้กันมาก★ 44.1Kอัปเดต 5 เดือนที่ผ่านมา

รันบนคลาวด์✓ puter.com

ติดตั้ง

XcodeBuildMCP

ให้ AI จัดการโปรเจกต์ Xcode สั่ง build และใช้ iOS Simulator

โดย getsentryใช้กันมาก↓ 130.5K/สัปดาห์★ 6.6Kอัปเดต 4 เดือนที่ผ่านมา

รันบนเครื่อง✓ xcodebuildmcp.com

ติดตั้ง

XcodeBuildMCP

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

โดย cameroncookeใช้กันมาก↓ 130.5K/สัปดาห์★ 6.6Kอัปเดต 14 เดือนที่ผ่านมา

รันบนเครื่อง

ติดตั้ง

README จากผู้ทำ

เปิดอ่าน README

ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ

Claude Replay

The observability layer for Claude Code sessions — search, analytics, and visualization across every project.

Claude Code's --resume/--continue and /rewind recover *the session you're in*. Claude Replay does the part they don't: it hooks passively into every session, records what happened to a local SQLite store, and makes every past session — across every project — searchable, comparable, measurable, and exportable. Full-text search, per-session insight metrics, death-cause classification (*why* a session ended), session diffing, a web dashboard, and a terminal UI — none of which Claude Code has natively.

Claude Code session

| hooks (PreToolUse · PostToolUse · Stop) | v ~/.claude-replay/sessions.db ← events + checkpoints | +----+--------------------+ | | | MCP tools Dashboard TUI (resume) :8766 (browse)

Passive hooks write. MCP tools, the web dashboard, and the terminal UI read. Nothing leaves your machine.

How this complements native Claude Code

Claude Replay is additive — it layers on top of the built-ins, it doesn't replace them.

You want to…	Use
Resume / continue the current session	Native `claude --continue`, `--resume`
Undo file + conversation changes in a session	Native `/rewind`
Search every past session by content, tool, or outcome	Replay `search`
See why a session ended + per-session metrics	Replay `status` / `replay_insights`
Compare two runs side by side	Replay `diff`
Visualize a session timeline / browse all projects	Replay dashboard + TUI
Export a session as HTML / JSON / Markdown	Replay `export --format`

Think of native resume/rewind as *recovery*, and Replay as *observability* over your whole history.

Architecture

Passive hooks write to SQLite. MCP tools read from SQLite. Dashboard + TUI visualize SQLite. That's the whole system.

Layer	File	Role
Store	`claude_replay/store.py`	All DB access — sessions, events, checkpoints
Hooks	`claude_replay/hooks.py`	Record tool calls + auto-checkpoint, dispatched by `claude-replay hook`
Recovery	`claude_replay/resume.py`	Generate a resume brief from a session
Export	`claude_replay/export.py`	Render a session as a self-contained HTML trace
Server	`claude_replay/server.py`	Starlette app — MCP SSE + JSON API + static dashboard
TUI	`claude_replay/tui.py` + `tui_client.py`	Textual session browser over the JSON API
CLI	`claude_replay/cli.py`	Every subcommand

Port 8766 deliberately one above Claude Bridge's 8765, so the two siblings can run side by side without colliding.

Quickstart

1. Install

pip install claude-replay

Or from a clone if you'd like to hack on it:

git clone https://github.com/constripacity/Claude-Replay.git

cd Claude-Replay pip install -e .[dev] # editable install with test/lint deps pip install -e .[tui] # add the terminal UI deps (textual, httpx)

If pip install -e fails on your environment (a known hatchling editable-install quirk on some setups), install the deps directly instead:

pip install mcp starlette uvicorn anyio textual httpx.

2. Install the hooks

This wires Replay into Claude Code by merging three hooks into ~/.claude/settings.json. It's idempotent and leaves any other tools' hooks untouched.

claude-replay install

✓ Installed Claude Replay hooks into ~/.claude/settings.json

PreToolUse → claude-replay hook pre-tool PostToolUse → claude-replay hook post-tool Stop → claude-replay hook stop

From now on, every Claude Code session is recorded automatically. Remove the hooks any time with claude-replay uninstall (it removes only Replay's hooks).

Confirm it's actually wired up — the one check that matters:

claude-replay doctor

Claude Replay — doctor

✓ Hooks installed: PreToolUse / PostToolUse / Stop are in settings.json ✓ Hook command on PATH: claude-replay → …/claude-replay ✓ Database: ~/.claude-replay/sessions.db ✓ Sessions recorded: 3 sessions; most recent 5m ago

All good — Replay is installed and recording. ✓

If doctor warns that claude-replay isn't on PATH, the hooks can't run and nothing is recorded — put your install directory on PATH and re-run it.

3. Start the server (dashboard + MCP tools)

claude-replay serve                 # defaults: 127.0.0.1:8766

claude-replay serve --port 9000 # custom port claude-replay serve --host 0.0.0.0 # bind all interfaces

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Claude Replay — Session checkpoint & recovery server Version: 0.4.1 DB: ~/.claude-replay/sessions.db http://localhost:8766/ ← Dashboard http://localhost:8766/sse ← MCP config http://localhost:8766/api/state ← JSON state http://localhost:8766/status ← Health check ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

4. (Optional) Register the MCP tools with Claude Code

So a running Claude Code session can call replay_resume, replay_checkpoint, etc. directly. Two ways:

SSE (alongside the dashboard — needs claude-replay serve running):

claude mcp add --transport sse -s user claude-replay http://localhost:8766/sse

stdio (no server process — the client launches Replay on demand):

claude mcp add -s user claude-replay -- claude-replay mcp

or, without installing: uvx claude-replay mcp

Verify with claude mcp list claude-replay should show ✓ Connected. Inside an already-running session, type /mcp to re-handshake.

When a session dies

# What's the state of the last session?

claude-replay status

Print a paste-ready resume brief (most recent session, or pass an id)

claude-replay resume claude-replay resume

Browse every recorded session in the terminal

claude-replay tui # needs claude-replay serve running

Export a session as a self-contained HTML trace

claude-replay export # → ~/.claude-replay/exports/ .html

Paste the resume output into a fresh Claude Code session and it picks up where the dead one left off objective, what was done, what's next, and which files were touched.

MCP Tools

Every connected Claude Code session gets these ten tools:

Tool	Description
`replay_status`	Current session summary objective, status, how it ended, event/checkpoint counts, last activity
`replay_checkpoint`	Force a checkpoint of the current session now, with an optional note
`replay_resume`	Generate a structured resume brief for a session (default: most recent)
`replay_sessions`	List recent sessions with status, model, duration, checkpoint count
`replay_insights`	Per-session metrics: how it ended, duration, tool calls, error rate, files touched, top tools
`replay_stats`	Cross-session analytics: tool calls, error rate, why sessions end, tool mix, per-project rollups
`replay_search`	Full-text search across sessions with filters (tool, cause, date, project), ranked by match count
`replay_diff`	Compare two sessions: metric deltas + which files each touched
`replay_tag`	Name a session and add/remove tags for later retrieval
`replay_export`	Render a session as a self-contained trace (html / json / md) and return the path

CLI Reference

Command	What it does
`claude-replay install`	Merge Replay's hooks into `~/.claude/settings.json` (idempotent)
`claude-replay uninstall`	Remove only Replay's hooks
`claude-replay status`	Current/last session at a glance, with insight metrics
`claude-replay sessions [--limit N]`	List recent sessions (with names + tags)
`claude-replay search [--tool T] [--cause C] [--since 7d] [--project P]`	Full-text search with filters (omit query to browse by filter)
`claude-replay diff`	Compare two sessions side by side
`claude-replay resume [session_id]`	Print a resume brief (default: most recent)
`claude-replay export [session_id] [--output DIR] [--format html\	json\	md]`	Render a trace
`claude-replay tag [session_id] [--name N] [--add a,b] [--remove c] [--clear]`	Name or tag a session
`claude-replay prune [--older-than 30d] [--yes]`	Delete sessions with no recent activity (destructive)
`claude-replay serve [--host H] [--port P]`	Start the MCP + dashboard server (port 8766)
`claude-replay mcp`	Serve the MCP tools over stdio (for `uvx claude-replay mcp` / MCP clients)
`claude-replay tui [--url URL]`	Launch the terminal session browser
`claude-replay reset [--yes]`	Delete all recorded sessions (destructive)
`claude-replay hook`	Internal — invoked by Claude Code's hooks

Dashboard & TUI

Web dashboard (claude-replay serve, then open http://localhost:8766/) a vanilla-JS view that polls every 2 s: session list (with how-it-ended badge + tags), a live search box, per-session timeline, and one-click "Copy Resume Brief" / "Export HTML". No CDN, no build step.

Terminal UI (claude-replay tui) a Textual browser in the same dark theme. A session sidebar, a live event feed, and a detail inspector showing how the session ended, its tags, the latest checkpoint, and files touched. Keys:

↑↓ navigate   Tab switch panel   Space pause

r resume (copies the brief to your clipboard) e export HTML trace ? help q quit

The TUI talks to the server over HTTP start claude-replay serve first (defaults to http://127.0.0.1:8766; point elsewhere with --url).

Configuration

Env var	Default	Purpose
`CLAUDE_REPLAY_DB`	`~/.claude-replay/sessions.db`	SQLite store location
`CLAUDE_SESSION_ID` / `CLAUDE_CODE_SESSION_ID`	—	Session identity (Claude Code sets this in the hook payload); falls back to these env vars, then to a hash of the project dir
`CLAUDE_REPLAY_CORS_ORIGIN`	localhost only	Comma-separated extra CORS origins for the server
`CLAUDE_REPLAY_NO_DASHBOARD`	—	Set to disable the static dashboard mount (MCP/JSON only)

The hook path is offline-first by design: it makes no network calls and completes in well under 50 ms just the one SQLite write. Large tool payloads are truncated at 8 KB per event so the DB stays lean.

Development

pip install -e .[dev]               # or install deps directly (see install note)

python -m pytest # full suite ruff check .

Tests use an isolated tmp_path SQLite database (the fresh_db fixture) — they never touch your real ~/.claude-replay/sessions.db. See CONTRIBUTING.md for the scope and the coding rules.

License

MIT see LICENSE.

Sibling to Claude Bridge. Built under the Constripacity banner.

Claude Replay

ภาพรวม

ใช้ทำอะไรได้

ติดตั้ง

ลง Python (uv) ในเครื่อง

สมัครและสร้างคีย์ของ Claude Replay

เปิดไฟล์ตั้งค่าของแอป Claude บนคอม

วางค่าตั้งนี้แล้วบันทึกไฟล์

ปิดแอป Claude แล้วเปิดใหม่

ลองเลย

คุณทำแบบนี้แทนได้

ลง Python (uv) ในเครื่อง

สมัครและสร้างคีย์ของ Claude Replay

เปิด Terminal

วางคำสั่งนี้แล้วกด Enter

พิมพ์ /mcp ใน Claude Code

ลองเลย

ลง Python (uv) ในเครื่อง

สมัครและสร้างคีย์ของ Claude Replay

กดปุ่มนี้เพื่อเปิด Cursor

ใส่คีย์ในช่องที่ว่างไว้

เปิดแชตของ AI ใน Cursor โหมด Agent

ลองเลย

ลง Python (uv) ในเครื่อง

สมัครและสร้างคีย์ของ Claude Replay

กดปุ่มนี้เพื่อเปิด VS Code

ใส่คีย์ในช่องที่ว่างไว้

เปิดแชตของ AI ใน VS Code โหมด Agent

ลองเลย

ติดตั้งในเครื่อง

ค่าที่ต้องใส่เอง

สรุป

ใช้กับโปรแกรมไหนได้

คู่มือที่เกี่ยวข้อง

ทำอะไรได้บ้าง

ผลตรวจเบื้องต้นi

ตัวตนผู้ทำตรงกับ repo

ยังมีคนดูแล

มีสัญญาอนุญาต (license)

endpoint ตอบ

ล็อกอินแบบ OAuth

คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง

พูดคุย

รีวิวจากผู้ใช้

เทียบกับตัวอื่นในหมวด เอกสาร ตาราง และงานออฟฟิศi

คำถามที่พบบ่อย

ตัวที่ใช้แทนได้

Puter MCP

XcodeBuildMCP

XcodeBuildMCP

README จากผู้ทำ

Claude Replay

How this complements native Claude Code

Architecture

Quickstart

1. Install

2. Install the hooks

3. Start the server (dashboard + MCP tools)

4. (Optional) Register the MCP tools with Claude Code

or, without installing: uvx claude-replay mcp

When a session dies

Print a paste-ready resume brief (most recent session, or pass an id)

Browse every recorded session in the terminal

Export a session as a self-contained HTML trace

MCP Tools

CLI Reference

Dashboard & TUI

Configuration

Development

License