diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..26b3625
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,11 @@
+# hatty 项目说明
+
+## 打包
+
+```bash
+npm run package:deb   # 构建 deb 包，输出到 dist/hatty_<version>_amd64.deb
+npm run package:all   # 构建 deb + AppImage
+```
+
+- 打包基于 electron-builder，配置在 `package.json` 的 `build` 字段。
+- 打包前会自动通过 @electron/rebuild 重编译 node-pty 以匹配 Electron 版本。