How long does the integration take?

Change one base URL in an OpenAI-compatible client, or install the Python or TypeScript SDK; the quickstart routes a first request in a few minutes.

Will this lock us into another vendor?

No. The router is Apache-2.0 open source, your provider keys stay yours, and the API is OpenAI-compatible, so leaving is a change of base URL.

What happens when a provider fails?

The router falls back to the next model your policy allows and records the fallback in the trace, so an outage costs a retry, not an incident.

agent-setup - Prompt - OpenSmartRoute

Name: agent-setup
Author: QuickerHub

Prompt file imported from QuickerHub/quicker-rpc (.cursor/commands/agent-setup.md). Copyright stays with the author.

qkrpc Agent 一键安装 / 刷新 skills + MCP

在 quicker-rpc 仓库根目录 执行。说明见 docs/agent-mcp-integration.md、docs/agent-skill-distribution.md。

何时执行

场景	命令
首次安装（交互选 Cursor / Codex / …）	`qkrpc agent install`
首次在本机 Cursor 接入 qkrpc（非交互）	`qkrpc agent setup`
热更新 / 升级 CLI 后刷新 skills、rules	`qkrpc agent setup --upgrade`
研发中改了 `docs/skills/` 或 `docs/agent-rules/`	`qkrpc agent setup --upgrade`（在仓库根目录，自动从 `docs/skills` 复制）
检查本机配置是否与 CLI 版本一致	`qkrpc agent setup --check`
团队仓库要 commit MCP 配置	`qkrpc agent setup --project --workspace <path>`（可选 `--project-skills`）
多宿主（VS Code、Claude Desktop 等）	`qkrpc agent setup --all`

向后兼容别名： qkrpc mcp install（与 agent setup 相同）。

前置

已安装 qkrpc.exe（Release 安装包或 build.ps1 -t 后的 %LOCALAPPDATA%\Programs\qkrpc）。
Quicker 已运行且已加载 QuickerRpc 插件（MCP 连通性与此无关，但使用工具时需要）。
在仓库根目录执行时，--upgrade 会优先从本仓库 docs/skills/、docs/agent-rules/qkrpc.mdc 复制（无需 --skill-source）。

执行（研发默认）

# 仅刷新 skills + rules + Claude 指引，不覆盖已有 MCP 配置
qkrpc agent setup --upgrade

首次安装或需重写 MCP 配置：

qkrpc agent setup --workspace D:\your-quicker-workspace

block_until_ms ≥ 15000。期望退出码 0，stderr 列出写入路径。

写入产物（用户级默认）

产物	路径
MCP	`~/.cursor/mcp.json`（stdio: `qkrpc mcp`）
Skills	`~/.cursor/skills/`：`qkrpc`、`quicker-rpc-knowledge`、`quicker-authoring`、`quicker-eval-expression`、`quicker-run`
Rules	`~/.cursor/rules/qkrpc.mdc`
Manifest	`~/.qkrpc/agent-setup.json`（`cliVersion` 用于 `--check`）

验证

qkrpc agent setup --check
# JSON for automation:
qkrpc agent setup --check --json

期望：qkrpc agent setup: OK (CLI x.y.z.r)，或 JSON 中 "ok": true。

然后在 Cursor：重载 MCP（Settings → MCP → 重启或 Reload）后应出现 user-qkrpc 工具。

可选连通性：

# MCP 工具 qkrpc_health 等价
qkrpc ping --json

研发 skill 时注意

Skill 源码目录：docs/skills/<name>/（发布时由 publish/publish-rpc.ps1 打入安装包 skills/）。
单 skill 调试：qkrpc agent setup --upgrade --skill-source docs/skills/qkrpc
第三方 MCP 不提供文件读写；磁盘编辑走宿主文件工具 + workspace_program patch；说明见 quicker-authoring / quicker://workspace/readme。
Codex：qkrpc agent setup --codex --project --workspace <根>；Agent 逐步说明见 docs/agent-mcp-self-install.md。
npm @quickerhub/qkrpc-mcp 仅 spawn qkrpc mcp，skills 仍须 agent setup。

本仓库（quicker-rpc 研发）

使用 用户级 qkrpc agent setup --upgrade，不要 --project（会生成 .cursor/mcp.json、.vscode/mcp.json、.mcp.json、.qkrpc/ 等重复本地配置，已 gitignore）。
终端 PATH 以已提交的 .vscode/settings.json 为准。

禁止

将 ~/.qkrpc/agent-setup.json、项目级 .qkrpc/ 或任意 mcp.json 提交到本仓库
用 --upgrade 代替首次 agent setup（无 manifest 时会失败）
连通失败时反复 shell qkrpc ping（用 MCP qkrpc_wait 或告知用户检查 Quicker/插件）

完成后汇报

--check 结果与 manifest 中的 cliVersion。
复制的 skill 列表（stderr 输出）。
提醒用户重载 Cursor MCP（若刚写入或改了 MCP 配置）。

Install agent-setup and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

# qkrpc Agent 一键安装 / 刷新 skills + MCP 在 **quicker-rpc 仓库根目录** 执行。说明见 [docs/agent-mcp-integration.md](../docs/agent-mcp-integration.md)、[docs/agent-skill-distribution.md](../docs/agent-skill-distribution.md)。 ## 何时执行 | 场景 | 命令 | |------|------| | 首次安装（交互选 Cursor / Codex / …） | `qkrpc agent install` | | 首次在本机 Cursor 接入 qkrpc（非交互） | `qkrpc agent setup` | | 热更新 / 升级 CLI 后刷新 skills、rules | `qkrpc agent setup --upgrade` | | 研发中改了 `docs/skills/*` 或 `docs/agent-rules/*` | `qkrpc agent setup --upgrade`（在仓库根目录，自动从 `docs/skills` 复制） | | 检查本机配置是否与 CLI 版本一致 | `qkrpc agent setup --check` | | 团队仓库要 commit MCP 配置 | `qkrpc agent setup --project --workspace <path>`（可选 `--project-skills`） | | 多宿主（VS Code、Claude Desktop 等） | `qkrpc agent setup --all` | **向后兼容别名：** `qkrpc mcp install`（与 `agent setup` 相同）。 ## 前置 1. 已安装 `qkrpc.exe`（Release 安装包或 `build.ps1 -t` 后的 `%LOCALAPPDATA%\Programs\qkrpc`）。 2. Quicker 已运行且已加载 QuickerRpc 插件（MCP 连通性与此无关，但使用工具时需要）。 3. 在仓库根目录执行时，`--upgrade` 会优先从本仓库 `docs/skills/`、`docs/agent-rules/qkrpc.mdc` 复制（无需 `--skill-source`）。 ## 执行（研发默认） ```powershell # 仅刷新 skills + rules + Claude 指引，不覆盖已有 MCP 配置 qkrpc agent setup --upgrade ``` 首次安装或需重写 MCP 配置： ```powershell qkrpc agent setup --workspace D:\your-quicker-workspace ``` `block_until_ms` ≥ **15000**。期望退出码 **0**，stderr 列出写入路径。 ## 写入产物（用户级默认） | 产物 | 路径 | |------|------| | MCP | `~/.cursor/mcp.json`（stdio: `qkrpc mcp`） | | Skills | `~/.cursor/skills/`：`qkrpc`、`quicker-rpc-knowledge`、`quicker-authoring`、`quicker-eval-expression`、`quicker-run` | | Rules | `~/.cursor/rules/qkrpc.mdc` | | Manifest | `~/.qkrpc/agent-setup.json`（`cliVersion` 用于 `--check`） | ## 验证 ```powershell qkrpc agent setup --check # JSON for automation: qkrpc agent setup --check --json ``` 期望：`qkrpc agent setup: OK (CLI x.y.z.r)`，或 JSON 中 `"ok": true`。然后在 Cursor：**重载 MCP**（Settings → MCP → 重启或 Reload）后应出现 `user-qkrpc` 工具。可选连通性： ```powershell # MCP 工具 qkrpc_health 等价 qkrpc ping --json ``` ## 研发 skill 时注意 - Skill 源码目录：`docs/skills/<name>/`（发布时由 `publish/publish-rpc.ps1` 打入安装包 `skills/`）。 - 单 skill 调试：`qkrpc agent setup --upgrade --skill-source docs/skills/qkrpc` - 第三方 MCP **不提供文件读写**；磁盘编辑走宿主文件工具 + `workspace_program` patch；说明见 `quicker-authoring` / `quicker://workspace/readme`。 - **Codex**：`qkrpc agent setup --codex --project --workspace <根>`；Agent 逐步说明见 `docs/agent-mcp-self-install.md`。 - npm `@quickerhub/qkrpc-mcp` 仅 spawn `qkrpc mcp`，**skills 仍须** `agent setup`。 ## 本仓库（quicker-rpc 研发） - 使用 **用户级** `qkrpc agent setup --upgrade`，**不要** `--project`（会生成 `.cursor/mcp.json`、`.vscode/mcp.json`、`.mcp.json`、`.qkrpc/` 等重复本地配置，已 gitignore）。 - 终端 PATH 以已提交的 `.vscode/settings.json` 为准。 ## 禁止 - 将 `~/.qkrpc/agent-setup.json`、项目级 `.qkrpc/` 或任意 `mcp.json` 提交到本仓库 - 用 `--upgrade` 代替首次 `agent setup`（无 manifest 时会失败） - 连通失败时反复 shell `qkrpc ping`（用 MCP `qkrpc_wait` 或告知用户检查 Quicker/插件） ## 完成后汇报 1. `--check` 结果与 manifest 中的 `cliVersion`。 2. 复制的 skill 列表（stderr 输出）。 3. 提醒用户重载 Cursor MCP（若刚写入或改了 MCP 配置）。

{ "prompt": "# qkrpc Agent 一键安装 / 刷新 skills + MCP\n\n在 **quicker-rpc 仓库根目录** 执行。说明见 [docs/agent-mcp-integration.md](../docs/agent-mcp-integration.md)、[docs/agent-skill-distribution.md](../docs/agent-skill-distribution.md)。\n\n## 何时执行\n\n| 场景 | 命令 |\n|------|------|\n| 首次安装（交互选 Cursor / Codex / …） | `qkrpc agent install` |\n| 首次在本机 Cursor 接入 qkrpc（非交互） | `qkrpc agent setup` |\n| 热更新 / 升级 CLI 后刷新 skills、rules | `qkrpc agent setup --upgrade` |\n| 研发中改了 `docs/skills/*` 或 `docs/agent-rules/*` | `qkrpc agent setup --upgrade`（在仓库根目录，自动从 `docs/skills` 复制） |\n| 检查本机配置是否与 CLI 版本一致 | `qkrpc agent setup --check` |\n| 团队仓库要 commit MCP 配置 | `qkrpc agent setup --project --workspace <path>`（可选 `--project-skills`） |\n| 多宿主（VS Code、Claude Desktop 等） | `qkrpc agent setup --all` |\n\n**向后兼容别名：** `qkrpc mcp install`（与 `agent setup` 相同）。\n\n## 前置\n\n1. 已安装 `qkrpc.exe`（Release 安装包或 `build.ps1 -t` 后的 `%LOCALAPPDATA%\\Programs\\qkrpc`）。\n2. Quicker 已运行且已加载 QuickerRpc 插件（MCP 连通性与此无关，但使用工具时需要）。\n3. 在仓库根目录执行时，`--upgrade` 会优先从本仓库 `docs/skills/`、`docs/agent-rules/qkrpc.mdc` 复制（无需 `--skill-source`）。\n\n## 执行（研发默认）\n\n```powershell\n# 仅刷新 skills + rules + Claude 指引，不覆盖已有 MCP 配置\nqkrpc agent setup --upgrade\n```\n\n首次安装或需重写 MCP 配置：\n\n```powershell\nqkrpc agent setup --workspace D:\\your-quicker-workspace\n```\n\n`block_until_ms` ≥ **15000**。期望退出码 **0**，stderr 列出写入路径。\n\n## 写入产物（用户级默认）\n\n| 产物 | 路径 |\n|------|------|\n| MCP | `~/.cursor/mcp.json`（stdio: `qkrpc mcp`） |\n| Skills | `~/.cursor/skills/`：`qkrpc`、`quicker-rpc-knowledge`、`quicker-authoring`、`quicker-eval-expression`、`quicker-run` |\n| Rules | `~/.cursor/rules/qkrpc.mdc` |\n| Manifest | `~/.qkrpc/agent-setup.json`（`cliVersion` 用于 `--check`） |\n\n## 验证\n\n```powershell\nqkrpc agent setup --check\n# JSON for automation:\nqkrpc agent setup --check --json\n```\n\n期望：`qkrpc agent setup: OK (CLI x.y.z.r)`，或 JSON 中 `\"ok\": true`。\n\n然后在 Cursor：**重载 MCP**（Settings → MCP → 重启或 Reload）后应出现 `user-qkrpc` 工具。\n\n可选连通性：\n\n```powershell\n# MCP 工具 qkrpc_health 等价\nqkrpc ping --json\n```\n\n## 研发 skill 时注意\n\n- Skill 源码目录：`docs/skills/<name>/`（发布时由 `publish/publish-rpc.ps1` 打入安装包 `skills/`）。\n- 单 skill 调试：`qkrpc agent setup --upgrade --skill-source docs/skills/qkrpc`\n- 第三方 MCP **不提供文件读写**；磁盘编辑走宿主文件工具 + `workspace_program` patch；说明见 `quicker-authoring` / `quicker://workspace/readme`。\n- **Codex**：`qkrpc agent setup --codex --project --workspace <根>`；Agent 逐步说明见 `docs/agent-mcp-self-install.md`。\n- npm `@quickerhub/qkrpc-mcp` 仅 spawn `qkrpc mcp`，**skills 仍须** `agent setup`。\n\n## 本仓库（quicker-rpc 研发）\n\n- 使用 **用户级** `qkrpc agent setup --upgrade`，**不要** `--project`（会生成 `.cursor/mcp.json`、`.vscode/mcp.json`、`.mcp.json`、`.qkrpc/` 等重复本地配置，已 gitignore）。\n- 终端 PATH 以已提交的 `.vscode/settings.json` 为准。\n\n## 禁止\n\n- 将 `~/.qkrpc/agent-setup.json`、项目级 `.qkrpc/` 或任意 `mcp.json` 提交到本仓库\n- 用 `--upgrade` 代替首次 `agent setup`（无 manifest 时会失败）\n- 连通失败时反复 shell `qkrpc ping`（用 MCP `qkrpc_wait` 或告知用户检查 Quicker/插件）\n\n## 完成后汇报\n\n1. `--check` 结果与 manifest 中的 `cliVersion`。\n2. 复制的 skill 列表（stderr 输出）。\n3. 提醒用户重载 Cursor MCP（若刚写入或改了 MCP 配置）。", "variables": [], "notes": "在 **quicker-rpc 仓库根目录** 执行。说明见 [docs/agent-mcp-integration.md](../docs/agent-mcp-integration.md)、[docs/agent-skill-distribution.md](../docs/agent-skill-distribution.md)。", "metadata": { "source": { "provider": "github-cursor-commands", "repository": "https://github.com/QuickerHub/quicker-rpc", "path": ".cursor/commands/agent-setup.md", "ref": "cc3e5eef59a381b2124a09d0dbff273c291a9c6c", "url": "https://github.com/QuickerHub/quicker-rpc/blob/cc3e5eef59a381b2124a09d0dbff273c291a9c6c/.cursor/commands/agent-setup.md", "key": "QuickerHub/quicker-rpc/.cursor/commands/agent-setup.md" } } }

agent-setup

About

qkrpc Agent 一键安装 / 刷新 skills + MCP

何时执行

前置

执行（研发默认）

写入产物（用户级默认）

验证

研发 skill 时注意

本仓库（quicker-rpc 研发）

禁止

完成后汇报

Install agent-setup and it becomes one more candidate the router can pick - when it fits.

What it costs to adopt - in engineering time.

One base URL

No vendor lock-in

Failover built in

Use it

Manifest

Reviews