diff --git a/README.md b/README.md
index 804acd9..dfd3efe 100644
--- a/README.md
+++ b/README.md
@@ -60,6 +60,16 @@ credential store, and deterministic per-agent projections.
 
 <sub>Traffic snapshot: 2026-08-10. GitHub exposes clone and unique-visitor analytics only to maintainers, so those values are a dated, transparent snapshot rather than a token-backed public badge.</sub>
 
+### Star history
+
+<p align="center">
+  <a href="https://www.star-history.com/#JNHFlow21/agent-switch&Date">
+    <img width="800" src="https://api.star-history.com/svg?repos=JNHFlow21/agent-switch&type=Date" alt="Agent Switch star history chart">
+  </a>
+</p>
+
+<sub>Live white-background chart from Star History. It follows public GitHub star data and becomes more informative as the repository grows.</sub>
+
 The native app follows the macOS language preference and ships complete
 **English** and **Simplified Chinese** interface catalogs.
 
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 94a4794..db47b31 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -58,6 +58,16 @@ Agent Switch 用一个本地 MCP 注册表、一个私密凭据存储和可重
 
 <sub>数据快照日期：2026-08-10。GitHub 只向仓库维护者提供克隆与独立访客数据，因此这里采用注明日期的透明快照，而不是需要私密 Token 的公开徽章。</sub>
 
+### Star 增长曲线
+
+<p align="center">
+  <a href="https://www.star-history.com/#JNHFlow21/agent-switch&Date">
+    <img width="800" src="https://api.star-history.com/svg?repos=JNHFlow21/agent-switch&type=Date" alt="Agent Switch Star 增长曲线">
+  </a>
+</p>
+
+<sub>这是由 Star History 提供的动态白底增长曲线，读取 GitHub 公开 Star 数据；随着项目获得更多 Star，曲线会自动变得更完整。</sub>
+
 原生应用会跟随 macOS 的语言偏好，并完整提供**英文**与**简体中文**界面。
 
 ## 快速开始
diff --git a/tests/test_localization_catalog.py b/tests/test_localization_catalog.py
index 1a3131b..7045779 100644
--- a/tests/test_localization_catalog.py
+++ b/tests/test_localization_catalog.py
@@ -38,6 +38,11 @@ def test_readmes_use_the_sanitized_english_dashboard(self) -> None:
         for readme in ("README.md", "README.zh-CN.md"):
             self.assertIn(image, (ROOT / readme).read_text())
 
+    def test_readmes_embed_the_live_star_history_chart(self) -> None:
+        chart = "https://api.star-history.com/svg?repos=JNHFlow21/agent-switch&type=Date"
+        for readme in ("README.md", "README.zh-CN.md"):
+            self.assertIn(chart, (ROOT / readme).read_text())
+
 
 if __name__ == "__main__":
     unittest.main()