Package Exports

quantex-cli
quantex-cli/package.json

Readme

Quantex CLI

统一的 AI Agent CLI 管理工具，支持安装、更新、卸载、查询、快捷启动主流 AI 编程助手。

支持的 Agent

Agent	命令	别名	描述
Claude Code	`quantex claude` / `qtx claude`	-	Anthropic 官方 AI 编程助手 CLI
Codex	`quantex codex` / `qtx codex`	-	OpenAI 官方 AI 编程助手 CLI
Copilot	`quantex copilot` / `qtx copilot`	-	GitHub Copilot 命令行工具
Cursor	`quantex cursor` / `qtx cursor`	`agent`	Cursor AI 编程助手命令行工具
Droid	`quantex droid` / `qtx droid`	-	Factory AI 软件工程 Agent CLI
Gemini	`quantex gemini` / `qtx gemini`	-	Google 开源 AI 编程助手 CLI
OpenCode	`quantex opencode` / `qtx opencode`	-	开源 AI 编程 CLI
Pi	`quantex pi` / `qtx pi`	-	极简可扩展的终端编程 Agent

安装

# 使用 Bun
bun add -g quantex-cli

# 使用 npm
npm i -g quantex-cli

也可以从 GitHub Releases 下载对应平台的独立二进制，或使用安装脚本：

curl -fsSL https://raw.githubusercontent.com/Drswith/quantex-cli/main/install.sh | sh

Windows PowerShell:

irm https://raw.githubusercontent.com/Drswith/quantex-cli/main/install.ps1 | iex

安装后可使用 quantex 或短别名 qtx 命令。

使用

安装 Agent

quantex install claude
qtx i claude

更新 Agent

quantex update claude
quantex u claude

quantex update --all

quantex update 和 quantex update --all 现在共用同一套更新策略层：

managed：优先按 Quantex 已记录的安装来源更新
self-update：使用 agent 自带的更新命令
manual-hint：不自动更新，只给出明确提示

quantex update --all 会优先使用 ~/.quantex/state.json 里记录的实际安装来源进行批量更新：

bun 会批量合并为一条 bun update -g --latest ...
npm 会批量合并为一条 npm install -g ...@latest
brew、winget 会按记录的安装器标识逐个更新
script、binary 或仅在 PATH 中探测到但没有可自动更新能力的 agent 不会被错误并入托管更新命令

对于支持自更新的 agent，list、info、update 输出会明确显示 command update 或 self-update。

升级 Quantex CLI

quantex upgrade

# 只检查是否有更新
quantex upgrade --check

# 使用 beta channel
quantex upgrade --channel beta

当前自身升级支持：

通过 Bun 全局安装的 quantex-cli
通过 npm 全局安装的 quantex-cli
通过独立二进制安装的 quantex

Binary 自升级具备：

release manifest 解析
SHA256 checksum 校验
升级锁
post-upgrade verify
.bak 最小回滚
Windows 延迟替换

如果升级失败，upgrade 和 doctor 都会给出与安装来源匹配的恢复方式。

卸载 Agent

quantex uninstall claude
quantex rm claude

列出所有 Agent

quantex list
qtx ls

list 会显示每个 agent 的安装状态、当前版本、更新方式和安装来源。例如：

managed update 表示 Quantex 能按记录的安装器执行更新
command update 表示当前 agent 支持自更新
manual update 表示当前来源不支持自动更新
managed via bun (...)、managed via brew (...) 表示有明确来源记录
detected in PATH 表示命令存在，但不是由当前 Quantex 状态追踪到的安装

查看 Agent 详情

quantex info claude

info 会显示：

当前平台可用的安装方式
当前记录的安装来源与生命周期
当前版本和可检测到的最新版本
agent 自带的自更新命令

快捷启动 Agent

quantex claude --dangerously-skip-permissions
qtx claude --dangerously-skip-permissions
quantex agent --help

如果 agent 未安装，Quantex 会提示是否先安装再启动。

配置管理

quantex config
quantex config get defaultPackageManager
quantex config set defaultPackageManager npm
quantex config set npmBunUpdateStrategy respect-semver
quantex config set selfUpdateChannel beta
quantex config reset

环境检查

quantex doctor

doctor 会检查：

bun、npm、brew、winget 是否可用
Quantex CLI 自身的版本、安装来源、是否支持自动升级
Quantex CLI 是否有新版本以及对应恢复方式
已安装 agent 的版本状态
当前环境是否缺少任何可用于托管安装/更新的安装器

配置

配置文件位于 ~/.quantex/config.json，当前支持：

{
  "defaultPackageManager": "bun",
  "npmBunUpdateStrategy": "latest-major",
  "selfUpdateChannel": "stable",
  "networkRetries": 2,
  "networkTimeoutMs": 10000,
  "versionCacheTtlHours": 6
}

配置项说明：

defaultPackageManager：控制托管安装器的优先尝试顺序
npmBunUpdateStrategy：
- latest-major：升级到 registry 最新版本，默认值
- respect-semver：保留包管理器默认的 semver 更新语义
selfUpdateChannel：Quantex CLI 自升级默认 channel，支持 stable / beta
networkRetries：版本查询和 release 元数据请求重试次数
networkTimeoutMs：网络请求超时时间
versionCacheTtlHours：版本与 release 元数据缓存 TTL

状态文件

Quantex 会在 ~/.quantex/state.json 中记录运行时状态，例如：

agent 的实际安装来源
Quantex CLI 自身的安装来源

这个状态文件主要用于：

让 update --all 能先生成更新计划，再按安装来源分组执行
避免混合安装场景下误用错误的更新方式
支撑 list、info、doctor、upgrade 的来源判断和恢复提示

开发

bun install
bun run dev
bun run test
bun run test:watch
bun run lint
bun run lint:fix
bun run typecheck
bun run build
bun run build:bin
bun run release:artifacts

release:artifacts 会统一生成并校验：

dist/bin/SHA256SUMS.txt
dist/bin/manifest.json

JSPM

quantex-cli