deepagents-cli (JavaScript/TypeScript)
概述
具有持久化内存的开源终端编码助手。功能包括:文件操作、shell 执行、网络搜索、HTTP 请求、任务规划、内存、HITL 和技能。
安装
npm install -g deepagents-cli
# 启动 CLI
deepagents
CLI 命令
| 命令 | 描述 |
|---------|-------------|
| deepagents | 启动 CLI |
| deepagents list | 列出 agents |
| deepagents skills | 管理技能 |
| deepagents help | 显示帮助 |
| deepagents reset --agent NAME | 清除内存 |
| deepagents threads list | 列出会话 |
| deepagents threads delete ID | 删除会话 |
内存 (AGENTS.md)
全局内存
~/.deepagents/<agent_name>/AGENTS.md
存储:个性、编码偏好、沟通风格
项目内存
.deepagents/AGENTS.md (需要 .git 文件夹)
存储:项目架构、约定、团队指南
技能
# 创建技能
deepagents skills create test-skill
# 项目技能
cd /path/to/project
deepagents skills create test-skill --project
位置:
- 全局:
~/.deepagents/<agent_name>/skills/ - 项目:
.deepagents/skills/
决策表:内存 vs 技能
| 内容 | 位置 | 原因 | |---------|----------|-----| | 编码风格 | AGENTS.md (全局) | 始终相关 | | 项目架构 | AGENTS.md (项目) | 项目上下文 | | 测试工作流 | 技能 | 任务特定 | | 大型文档 | 技能 | 按需加载 |
注意事项
1. 项目根目录需要 .git
# ❌ 无项目内存
cd /project # 无 .git
deepagents
# ✅ 初始化 git
git init
deepagents
2. 技能位置
# ❌ 错误
/project/skills/SKILL.md
# ✅ 正确
/project/.deepagents/skills/skill-name/SKILL.md
3. 网络搜索需要 API Key
export TAVILY_API_KEY="your-key"
deepagents