用途:通过命令行操作 Basecamp 项目,适合在终端或脚本中批量、自动化地管理项目内容,所有命令输出 JSON,便于用 jq 等工具处理。
主要能力:覆盖项目与看板(projects/boards/columns)、卡片与卡片步骤(cards/card/card-create/card-update/move,以及 step-create 等)、待办列表与待办、待办分组、消息、评论、文档、日程与事件、Campfire 发帖、搜索、人员与项目成员、自动签到(questionnaire/questions/answers)、上传与查看上传、归档/回收站、消息类型、活动事件等。Recording ID 可跨类型通用(待办、卡片、消息等)。
使用方式:先执行 basecamp version 验证安装,执行 basecamp projects 验证认证(如未认证运行 basecamp auth)。可在某目录创建 .basecamp.yml 写入 project_id,之后在该目录的命令可省略 project_id。多数命令形如 basecamp <子命令> [project_id] [id],如 basecamp cards [project_id] <board_id>、basecamp card-create [project_id] <board_id> --column <col_id> --title "Title"。部分命令支持 --comments 附带评论;搜索支持 --type(Todo、Message、Document、Kanban::Card、Schedule::Entry、Comment)与 --project 过滤。上传命令 basecamp upload /path/to/file.pdf 返回 sgid,uploads 需 vault_id(可从 docs 输出获取)。
限制:错误以 JSON 输出到 stderr,例如 {"error": "not authenticated, run 'basecamp auth' first"}。需有效的 Basecamp 账号与认证。具体收费、价格、平台支持范围等资料暂未提供。