@deltamind/cli
v1.0.1
Published
Operator CLI for DeltaMind sessions — inspect, export, replay, debug
Maintainers
Readme
这是什么?
@deltamind/cli 是 DeltaMind 的操作者命令行工具,它提供了 8 个命令,允许您在终端中检查、调试和导出代理的内存会话。
安装
npm install -g @deltamind/cli命令
| 命令 | 描述 |
|---------|-------------|
| deltamind inspect | 显示活动状态(所有项目或 --kind goal) |
| deltamind export | 导出上下文块(--max-chars 4000,--for ai-loadout) |
| deltamind changed --since <ref> | 显示自某个时间戳、序列或回合 ID 以来的更改 |
| deltamind explain <id> | 显示某个项目的完整历史记录,包括字段、变更和来源 |
| deltamind replay | 查看来源日志(--since,--type accepted) |
| deltamind suggest-memory | 建议更新内存文件(--min-confidence 0.8) |
| deltamind save | 将会话保存到 .deltamind/ 目录(使用 --from-stdin 选项可以从标准输入读取快照) |
| deltamind resume | 加载会话并显示统计信息 |
所有命令都支持 --json 选项,用于生成机器可读的输出。
设计
- 支持管道传输 — 标准输出是数据,标准错误输出是诊断信息,不包含 ANSI 编码。
- 退出码 — 0 表示成功,1 表示使用错误,2 表示没有
.deltamind/目录。 - 零配置 — 通过从当前工作目录向上查找来定位
.deltamind/目录(类似于.git/)。 - 无框架 — 使用 Node 18+ 的
parseArgs,除了@deltamind/core之外没有其他运行时依赖。
示例
# What changed in the last hour?
deltamind changed --since 2025-01-15T10:00:00Z
# Export context for an LLM prompt
deltamind export --max-chars 4000
# Debug a specific item
deltamind explain goal::build-rest-api
# Pipe session state from another tool
cat snapshot.json | deltamind save --from-stdin链接
许可证
MIT
