diff --git a/README.md b/README.md
index 2bc999d..d3b73d5 100644
--- a/README.md
+++ b/README.md
@@ -8,6 +8,10 @@ CarryCtx is a persistence and control layer, not an agent runtime. Your external
 
 [English](README.md) | [简体中文](README.zh-CN.md)
 
+<p align="center">
+  <img src="https://cdn.xuepoo.xyz/carryctx/carryctx-promo.gif" alt="CarryCtx CLI walkthrough: init, agent register, task create, claim, session start, progress note, checkpoint, resume" width="100%">
+</p>
+
 ## The Project Lifecycle
 
 CarryCtx follows the chain a real project needs:
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 63b32c2..c010724 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -8,6 +8,10 @@ CarryCtx 是持久化与控制层，不是 Agent 运行时。外部 harness 仍
 
 [English](README.md) | 简体中文
 
+<p align="center">
+  <img src="https://cdn.xuepoo.xyz/carryctx/carryctx-promo.gif" alt="CarryCtx CLI 演示：init、agent register、task create、claim、session start、progress note、checkpoint、resume" width="100%">
+</p>
+
 ## 项目生命周期
 
 CarryCtx 覆盖真实项目所需的完整链条：