bobi-cli

波比日常管理系统 CLI 客户端（v0.5.5）

纯 HTTP 客户端，可安装在任何机器上远程操作波比系统。所有命令通过 Bearer token 访问 Hono API Server，禁止直连数据库。

安装

npm install -g bobi-cli

快速开始

1. 登录

bobi login http://your-server:4000 username

登录成功后令牌保存到 ~/.bobi/config.json，后续命令自动使用。

2. 查看填写规范

bobi docs idea       # 想法填写规范
bobi docs task       # 任务填写规范
bobi docs goal       # 目标填写规范
bobi docs project    # 项目填写规范
bobi docs note       # 笔记填写规范
bobi docs relation   # 关系填写规范
bobi docs feedback   # 反馈填写规范

3. 查看全局状态

bobi snapshot          # 活跃目标 / 进行中项目 / 今日焦点任务 / 阻塞 / 超期想法
bobi focus today       # 今日焦点任务摘要

命令一览

任务 (task)

bobi task add "标题" [-p P0] [--due 2026-09-01] [--domain 领域] [--parent T-001] [--recur weekly] [--attr key=val]
bobi task list [-s todo|doing|done|blocked] [-p P0] [--domain 领域] [--overdue] [--limit 20]
bobi task update <ref> [-s doing] [-p P1] [--due 日期] [--assignee agent:claude-code] [--blocked-reason 原因] [-r 变更原因]
bobi task done <ref> [-r 完成备注]
bobi task start <ref>              # 标记为今日焦点 + 状态改为 doing
bobi task focus <ref> [--clear]    # 标记 / 清除今日焦点
bobi task log <ref> "备注"         # 追加执行日志
bobi task timer start <ref>        # 开始计时
bobi task timer pause <ref>        # 暂停计时
bobi task timer stop <ref>         # 结束计时（自动汇总 actual_hours）
bobi task children <ref>           # 列出子任务
bobi task promote <ref> [--name 名称] [--type 开发型]  # 提升为项目
bobi task rm <ref>

目标 (goal)

bobi goal add "名称" [--horizon lifetime|annual|quarterly|monthly] [--due 日期] [--parent G-001] [--attr key=val]
bobi goal list [-s 进行中] [--horizon quarterly] [--tree]
bobi goal update <ref> [-s 进行中] [--progress 30] [--defer-reason 原因] [--resume-condition 条件] [-r 变更原因]
bobi goal focus <ref> [--week 2026-W35] [--clear]  # 声明 / 清除本周焦点目标
bobi goal tree <ref>               # 展示目标子树
bobi goal children <ref>           # 列出直接子目标
bobi goal rm <ref>

项目 (project)

bobi project add "名称" [--type 开发型|研究型|运营型|咨询型] [--domain 领域] [--parent P-001] [--attr key=val]
bobi project list [-s 进行中] [--type 开发型]
bobi project update <ref> [-s 进行中] [--pause-reason 原因] [-r 变更原因]
bobi project tasks <ref>           # 列出项目下的任务
bobi project children <ref>        # 列出子项目
bobi project rm <ref>

想法 (idea)

bobi idea add "标题" [--type spark|insight|thinking] [-b 详细内容] [--domain 领域] [--attr key=val]
bobi idea list [-s incubating|converted|discarded] [--overdue] [--domain 领域]
bobi idea update <ref> [-s discarded] [--energy high|medium|low] [--discard-reason 原因]
bobi idea convert <ref> --to task|project|goal [--name 生成实体名称]
bobi idea rm <ref>

笔记 (note)

bobi note "内容"                              # 追加到今日笔记
bobi note "内容" --date 2026-08-20           # 追加到指定日期
bobi note "内容" --entry-type agent_dialog   # 标注条目类型

焦点管理 (focus)

bobi focus today         # 今日焦点任务摘要（进度 + 待完成 + 已完成）
bobi focus switch <ref>  # 切换焦点任务（标记今日焦点 + 状态改 doing）
bobi focus review        # 当日收尾摘要（完成情况 + 未完成处置提示）

搁置看板 (deferred)

bobi deferred                                                       # 搁置目标 / 暂停项目 / 超期想法
bobi deferred review --action resume --ref G-001                    # 复启
bobi deferred review --action discard --ref I-001 --reason "原因"   # 丢弃

实体详情 (show)

完整详情：content + attrs + 关系 + 参与者 + 最近5条变更。

bobi show task T-AI-001
bobi show goal G-2026-Q3
bobi show project P-BOBI-V2
bobi show idea I-001
bobi show decision DC-001
bobi show agent AG-WORKBUDDY

实体上下文 (context)

供 Agent 读取，返回 JSON（content + attrs + 关系 + 最近事件 + 变更历史）。

bobi context task T-AI-001
bobi context goal G-2026-Q3

工作台快照 (snapshot)

bobi snapshot    # 活跃目标 / 进行中项目 / 今日焦点任务 / 阻塞任务 / 超期想法 / 近7天完成

变更历史 (history)

bobi history task <ref> [-l 10]
bobi history goal <ref>
bobi history project <ref>
bobi history idea <ref>
bobi history show <entityType> <ref>   # 通用格式

实体关系 (relation)

# 创建
bobi relation add goal G-001 project P-001 -t served_by
bobi relation add task T-001 task T-002 -t depends_on

# 快捷命令（跨类型自动解析 ref）
bobi relation link-served-by <sourceRef> <targetRef>
bobi relation link-spawned-from <sourceRef> <targetRef>
bobi relation link-task-goal <taskRef> <goalRef> [--type main|support]
bobi relation link-task-project <taskRef> <projectRef>
bobi relation link-goal-project <goalRef> <projectRef>

# 查看
bobi relation list <entityType> <ref> [-d source|target|both] [-t 关系类型]
bobi relation graph <ref>    # 完整关系网络（上下游 + 参与者）

# 删除
bobi relation rm <relationId>
bobi relation rm --from <ref> --to <ref> --type <relationType>   # 语义删除

标签管理 (label)

# 维度
bobi label dimension add <key> <name> -e task|goal|project|idea [--multi] [-d 描述]
bobi label dimension list [-e task]
bobi label dimension rm <key>

# 枚举值
bobi label value add <key> <value> <valueName> [-m 含义说明]
bobi label value list <key>
bobi label value rm <key> <value>

反馈记录 (feedback)

bobi feedback add "内容" [--ref T-001] [--tag positive|negative|suggestion]
bobi feedback list [--ref T-001] [--tag negative] [--limit 20]

Agent 管理 (agent)

bobi agent list                      # 列出所有 AgentDefinition
bobi agent use <code>                # 注入当前工作区（.claude/CLAUDE.md + settings.json）
bobi agent use <code> --global       # 注入全局 ~/.claude/CLAUDE.md
bobi agent status                    # 显示当前注入的 agent
bobi agent eject                     # 清除注入（仅删除 bobi 生成的文件）

启动 Agent (run)

组合命令：注入 agent + 创建 session + 启动 claude + 退出时自动记录会话结束。

bobi run <code>
bobi run <code> --outcome "会话摘要"

工作区管理 (workspace)

bobi workspace register [--project P-001] [--name 名称]   # 注册当前目录为工作区
bobi workspace list
bobi workspace status    # 当前目录的工作区信息

会话管理 (session)

bobi session start --agent <code>              # 手动记录会话开始
bobi session end <id> [--outcome "摘要"]
bobi session list [--agent <code>] [--limit 20]
bobi session show <id>                         # 含 context snapshot

用户管理 (user)

仅限服务器本机运行，需要 DATABASE_URL 环境变量，用于引导阶段创建初始账号。

bobi user add <username> -p <password>

ref 格式

所有 <ref> 优先匹配 code，其次匹配 UUID 前缀（够唯一即可）。

bobi task done T-AI-001    # code
bobi task done ac54        # UUID 前缀

编码规范建议

| 实体 | 格式 | 示例 | |------|------|------| | 任务 | T-<主题>-<序号> | T-AI-001 | | 目标 | G-<年份>-<周期> | G-2026-Q3 | | 项目 | P-<项目名缩写> | P-BOBI-V2 | | 想法 | I-<主题>-<序号> | I-AI-001 | | 决策 | DC-<序号> | DC-001 | | Agent | AG-<名称> | AG-WORKBUDDY |

配置文件

~/.bobi/config.json：

{
  "serverUrl": "http://your-server:4000",
  "token": "...",
  "username": "jeffrey"
}

注意：CLI 连接 Hono API Server（默认端口 4000），不是 Next.js 地址（3000）。

版本管理

bobi version                   # 显示当前版本，检查是否有新版本
npm install -g bobi-cli        # 升级到最新版