xavi-ai

xavi-ai 是一个轻量 Codex 启动器，可在 Codex 场景下替代 CC-Switch、MCP-Router。

解决了什么问题：

• CC-Switch 每个供应商是单独的配置，codex 运行过程中修改的配置无法同步其他供应商。
• CC-Switch MCP 服务器管理只支持全局配置，无法按项目配置。
• CC-Switch Skills 管理只支持全局配置，推荐使用 skls-mgr 按项目管理。
• MCP-Router 支持项目级别 MCP 配置，但将配置与项目对应仍然繁琐。

使用

1. 初始化配置：

npx xavi-ai init

2. 自定义配置：

在 ~/.xavi-ai/proxy.json 和 ~/.xavi-ai/mcp.json 配置文件中，按示例写入供应商和 MCP 配置。

Windows 对应路径：

C:\Users\<用户名>\.xavi-ai\proxy.json
C:\Users\<用户名>\.xavi-ai\mcp.json

3. 启动 Codex：

npx xavi-ai

选择本次使用的供应商和 MCP 后，完成！

支持透传 Codex 参数：

npx xavi-ai -- --model gpt-5-codex
npx xavi-ai -- exec "review current changes"

配置文件

proxy.json 示例：

{
  "$schema": "https://raw.githubusercontent.com/Xaviw/xavi-ai/main/schemas/proxy.schema.json",
  "default": {
    "base_url": "https://example.com/v1",
    "api_key": "sk-..."
  }
}

mcp.json 示例：

{
  "$schema": "https://raw.githubusercontent.com/Xaviw/xavi-ai/main/schemas/mcp.schema.json",
  "github": {
    "type": "http",
    "url": "https://api.githubcopilot.com/mcp/",
    "headers": {},
    "bearer_token_env_var": "CODEX_GITHUB_PERSONAL_ACCESS_TOKEN"
  },
  "chromeDevtools": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "[email protected]"],
    "env": {}
  }
}

支持的 MCP 字段：

stdio: type, command, args, env, 其他 Codex MCP 配置项
http:  type, url, headers, 其他 Codex MCP 配置项
sse:   type, url, headers, 其他 Codex MCP 配置项

streamable-http 会按 http 处理。额外字段会原样映射到 Codex 的 mcp_servers.<name> 配置，字段值支持字符串、数字、布尔值、数组和对象，不支持 null。

供应商名称和 MCP 名称只能包含英文字母、数字、下划线和连字符。

开发

npm install
npm run build
npm test