youmind-cli

YouMind OpenAPI CLI — 通过命令行调用 YouMind OpenAPI。

安装

pnpm --filter youmind-cli build
npm link packages/youmind-cli

认证

优先级从高到低：

1. 环境变量（推荐，适合 CI/CD 和脚本）

   export YOUMIND_API_KEY=sk-ym-xxxxxxxxxxxx
   youmind call listCrafts

2. 命令行参数

   youmind call listCrafts --api-key sk-ym-xxxxxxxxxxxx

命令

help/version — 查看帮助和版本

youmind
youmind --help
youmind --version

search — 搜索 API

youmind search board          # 搜索含 "board" 的 API
youmind search craft
youmind search                # 无参数，列出所有 API

Compatibility alias: youmind searchApi ...

find — 搜索 YouMind 内容

youmind find "machine learning"                                  # 搜索整个 library
youmind find "machine learning" --scope library --top-k 10
youmind find "machine learning" --scope board --board-id xxx     # 仅搜索某个 board

• Requires YOUMIND_API_KEY
• Calls /openapi/v1/search
• Defaults to scope=library

web-search — 搜索互联网

youmind web-search "OpenAI responses API" --category general
youmind web-search "NVIDIA earnings" --category finance --freshness week
youmind web-search "multimodal agents" --category scholar --include-domains arxiv.org

• Requires YOUMIND_API_KEY
• Calls /openapi/v1/webSearch
• Supports general, image, video, news, tweet, finance, and scholar

info — 查看 API 调用说明

youmind info createBoard      # 查看 requestBody
youmind info listCrafts

info focuses on how to call an API successfully. It does not print response body schema.

Compatibility alias: youmind readApi ...

call — 调用 API

# --key value 形式
youmind call createBoard --name "My Board" --boardGroupId "xxx-uuid"

# JSON 字符串
youmind call createBoard '{"name":"My Board"}'

# stdin 管道
echo '{"name":"My Board"}' | youmind call createBoard

# 无参数
youmind call listCrafts

call 参数必须是 JSON、stdin JSON，或完整的 --key value 对；裸参数和缺少 value 的 flag 会直接报错。

Compatibility alias: youmind callApi ...

环境变量

| 变量 | 说明 | |------|------| | YOUMIND_API_KEY | API Key |

--api-key > 环境变量。

项目结构

packages/youmind-cli/
├── src/
│   ├── index.ts       # 入口 + 命令定义
│   ├── api.ts         # HTTP 调用 /openapi/v1/{name}
│   ├── search.ts      # 内容搜索命令
│   ├── web-search.ts  # 互联网搜索命令
│   └── spec.ts        # 拉取 OpenAPI spec
├── package.json
└── tsconfig.json