@cydm/pie 0.1.0

package/README.md

@@ -0,0 +1,150 @@
+# @cydm/pie
+
+Pie AI Agent CLI - 命令行交互界面
+
+## 安装
+
+```bash
+npm install -g @cydm/pie
+```
+
+## 使用
+
+### 环境变量
+
+设置 API Key：
+
+```bash
+export KIMI_API_KEY="your-api-key"
+```
+
+或创建配置文件 `~/.pie/config.json`：
+
+```json
+{
+  "provider": "kimi-cn",
+  "modelId": "kimi-k2.5",
+  "apiKey": "your-api-key"
+}
+```
+
+### 命令
+
+#### Print 模式（默认）
+
+直接输入 prompt，获取结果后退出：
+
+```bash
+pie "请列出当前目录的文件"
+pie chat "帮我写一个快速排序的 Python 代码"
+```
+
+#### Interactive 模式
+
+启动交互式 TUI 界面：
+
+```bash
+pie
+# 或
+pie chat
+```
+
+快捷键：
+- `Enter` - 提交消息
+- `Shift+Enter` / `Ctrl+Enter` - 换行（需 CSI u 支持的终端）
+- `\` + `Enter` - 换行（兼容所有终端）
+- `Ctrl+C` - 退出
+
+#### 帮助
+
+```bash
+pie help
+pie --help
+```
+
+## 功能特性
+
+- **Print 模式**：快速单次查询，适合脚本调用
+- **Interactive TUI**：完整的终端交互界面
+  - 实时流式响应显示
+  - 多行编辑器（Shift+Enter 换行）
+  - 工具执行状态透明展示
+  - Thinking 过程显示
+  - 主题系统（dark/light）
+- **工具支持**：read、write、edit、ls、grep、find、bash
+- **Session 管理**：自动保存对话历史
+
+### Session 管理
+
+Session 文件保存在 `~/.pie/sessions/` 目录。
+
+#### Slash 命令
+
+在 Interactive 模式下输入 `/` 显示命令菜单：
+
+| 命令 | 说明 |
+|------|------|
+| `/new` | 创建新 Session（保存当前并开启新的对话） |
+| `/resume` | 恢复之前的 Session（显示交互式选择器） |
+| `/session` | 显示当前 Session 信息 |
+| `/fork` | 从当前 Session 分叉创建新 Session |
+| `/tree` | 显示 Session 树状结构 |
+| `/settings` | 设置菜单（主题、思考级别） |
+| `/hotkeys` | 显示键盘快捷键 |
+| `/quit` | 退出 |
+
+#### 使用示例
+
+```bash
+# 启动交互模式
+pie chat
+
+# 聊几句...
+> 你好，我叫 Bob
+> 我喜欢用 TypeScript
+
+# 创建新 Session（之前的对话会被保存）
+/new
+
+# 在新 Session 中聊天
+> 你好
+
+# 恢复之前的 Session
+/resume
+# 使用 ↑↓ 选择，Enter 确认
+
+# AI 会记得之前的对话内容
+> 我叫什么名字？
+# AI: 你叫 Bob，之前告诉过我你喜欢 TypeScript
+```
+
+#### 快捷键
+
+| 快捷键 | 说明 |
+|--------|------|
+| `Enter` | 发送消息 |
+| `Shift+Enter` | 换行（需 CSI u 支持） |
+| `Ctrl+C` (按一次) | 清空编辑器 |
+| `Ctrl+C` (快速按两次) | 退出 |
+| `ESC` | 取消 / 返回上一级 |
+| `/` | 显示命令菜单 |
+
+## 终端要求
+
+对于完整的按键支持（Shift/Ctrl+Enter），推荐使用：
+- [Kitty](https://sw.kovidgoyal.net/kitty/)
+- [iTerm2](https://iterm2.com/)（启用 "Report modifier keys using CSI u"）
+- [Ghostty](https://ghostty.org/)
+
+## 开发
+
+```bash
+cd products/cli
+npm install
+npm run build
+npm test
+```
+
+## 许可证
+
+MIT