diff --git a/xiaoyu/agent.json b/xiaoyu/agent.json
new file mode 100644
index 000000000..bcfc59490
--- /dev/null
+++ b/xiaoyu/agent.json
@@ -0,0 +1,15 @@
+{
+  "id": "xiaoyu",
+  "name": "小羽 (Xiaoyu)",
+  "version": "0.33.0",
+  "description": "Coding agent with plan mode, session restore, model selector, and multi-provider routing — terminal TUI and ACP in one Python package.",
+  "repository": "https://github.com/pholex/zhinu",
+  "authors": ["Fenghuang"],
+  "license": "MIT",
+  "distribution": {
+    "uvx": {
+      "package": "xiaoyu-agent==0.33.0",
+      "args": ["--acp"]
+    }
+  }
+}
diff --git a/xiaoyu/icon.svg b/xiaoyu/icon.svg
new file mode 100644
index 000000000..ed6b483cd
--- /dev/null
+++ b/xiaoyu/icon.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16" fill="currentColor"><path fill-rule="evenodd" d="M14 2C10 1 5.5 2.5 3.5 6 2.3 8.2 1.6 11.5 1 15c3.5-.6 6.8-1.3 9-2.5C13.5 10.5 15 6 14 2ZM12.6 3.4 2.6 13.4l.7.7 10-10Z"/></svg>