| name | infinisynapse-cli |
| description | agent_infini CLI API 映射、CLI 网络请求排查、CLI 与 Server/Console 服务关系。
激活条件:
- 用户提到 agent_infini、CLI、task new、task ask、db ls、rag ls
- 用户要复刻 CLI 行为或排查 CLI 网络问题
|
InfiniSynapse CLI API
先读:
upstream-docs/infinisynapse-site/zh/markdown/cli-api-reference.md
upstream-docs/infinisynapse-site/markdown/cli-api-reference.md 作为英文补充参考
安装与来源(2026-07-09 核对)
-
官方一键安装(macOS/Linux,同时安装 CLI + companion skill,AI 编码工具可直接调用):
curl -fsSL https://infinisynapse.cn/cli-install/install.sh | bash
-
默认安装位置 ~/.infini/bin/agent_infini(Windows:%USERPROFILE%\.infini\bin\agent_infini.exe),不在 PATH 时用完整路径调用。
-
CLI 已开源:https://github.com/chaozwn/infinisynapse-cli(Go,MIT)。可 make build 自编译;排查 CLI 行为时可直接读源码(internal/client/sse.go、internal/task/task.go)。
-
agent_infini --update 自动更新(OSS manifest + SHA256 校验,--check 仅检查);agent_infini skill / --skill 输出面向 AI Agent 的命令规范。
-
首次使用:agent_infini init --api-key sk-xxx,配置写入 ~/.agent_infini/config.txt(server/console/api-key/prefer-language/default-output)。
-
输出默认 JSON(--table 切表格);操作类命令输出 {"success", "data", "message"},列表类直接输出数据结构,可管道给 jq。
服务关系
agent_infini 使用两类服务:
| Service | Default address | Role |
|---|
| Server | https://app.infinisynapse.cn | 任务、数据库、RAG、workspace 文件 |
| Console | https://api.infinisynapse.cn/api | 校验 API Key 并获取 userId |
两者可在 ~/.agent_infini/config.txt 覆盖。
CLI endpoint map
| CLI command | Endpoint(s) |
|---|
init | GET {console}/user/profile |
task new | GET /api/ai/events, POST /api/ai/message with newTask |
task ask | GET /api/ai/events, POST /api/ai/message with askResponse |
task cancel | POST /api/ai/message with cancelTask |
task ls | GET /api/ai_task/list |
task show | getTaskInfo, getUiMessageById, getTaskWorkspace |
task preview | POST /api/ai_task/previewFile |
task download | GET /api/tools/storage/downloadTaskFile/{taskId} |
db ls | GET /api/ai_database/list |
db enable/disable | POST /api/ai_database/enabled |
rag ls | GET /api/ai_rag_sdk |
rag enable/disable | POST /api/ai_rag_sdk/enabled |
Troubleshooting
1101 / 1105: API Key expired or invalid. Re-run agent_infini init or update config.
- Service unreachable: check
server and console addresses.
- Task not found: run
task ls.
- No available resources: run
task context, then enable DB/RAG resources.