Xioo Pilot Cabin

xioo - AI 驾驶舱智能管理工具 - 一个用于管理 AI 编程工具（如 Claude Code、Cursor 等）配置资源的命令行工具。

功能特性

• 资源管理: 安装、更新、卸载各类 AI 编程资源
• 多资源类型支持: Skills（技能）、Commands（命令）、Contexts（上下文）、MCP Servers
• 多目标安装: 支持选择安装到 Claude Code、Cursor 或两者
• 灵活的安装级别: 支持用户级别 (~/.claude) 或项目级别 (./.claude) 安装
• 依赖解析: 自动解析和安装资源依赖
• 多源支持: 支持内置注册表和 Git 远程源
• 配置集（Profile）: 支持一键安装预配置的资源组合
• TUI 交互界面: 提供终端用户界面进行资源浏览和安装
• 版本管理: 支持语义化版本控制和版本锁定

安装

npm install -g xioo-pilot-cabin

快速开始

查看帮助

xioo --help

搜索资源

# 搜索所有包含 "git" 的资源
xioo search git

# 按类型搜索
xioo search test --type skill

# 按标签搜索
xioo search --tag mcp

安装资源

# 安装单个资源（交互式选择目标和级别）
xioo install skill/git-operations

# 指定安装目标（Claude Code、Cursor 或两者）
xioo install mcp/context7 --target claude
xioo install mcp/context7 --target claude,cursor
xioo install mcp/context7 --target all

# 指定安装级别（user 或 project）
xioo install skill/code-review --scope user
xioo install skill/code-review --scope project

# 组合使用（跳过交互式提示）
xioo install mcp/context7 --target claude --scope user

# 安装配置集
xioo install profile:full-stack-dev

# 全局安装
xioo install skill/code-review --global

# 强制覆盖安装
xioo install skill/code-review --force

列出已安装资源

# 列出所有已安装资源
xioo list

# 简写
xioo ls

# 按类型过滤
xioo list --type skill

# 显示详细信息
xioo list --detailed

更新资源

# 更新指定资源
xioo update skill/git-operations

# 更新所有资源
xioo update --all

# 显示更新日志
xioo update --changelog

卸载资源

# 卸载资源
xioo uninstall skill/git-operations

# 简写
xioo rm skill/git-operations

# 强制卸载（跳过确认）
xioo rm skill/git-operations --force

交互式浏览（TUI）

# 启动交互式资源浏览器
xioo browse

管理源

# 列出所有配置的源
xioo source list

# 添加新的 Git 源
xioo source add my-source https://github.com/user/xioo-registry.git

# 添加时指定分支
xioo source add my-source https://github.com/user/xioo-registry.git --branch develop

# 更新源内容
xioo source update my-source

# 启用/禁用源
xioo source enable my-source
xioo source disable my-source

# 删除源
xioo source remove my-source

资源类型

Skills（技能）

技能是可复用的 AI 能力模块，提供特定领域的知识和操作能力。

xioo search --type skill
xioo install skill/<skill-name>

Commands（命令）

命令是可执行的脚本，用于自动化常见任务。

xioo search --type command
xioo install command/<command-name>

Contexts（上下文）

上下文提供项目或任务的背景信息，帮助 AI 更好地理解需求。

xioo search --type context
xioo install context/<context-name>

MCP Servers

MCP（Model Context Protocol）服务器提供外部工具和 API 的集成能力。

xioo search --type mcp
xioo install mcp/<mcp-name>

配置

配置文件位于 ~/.xioo/config.json，包含：

• 已安装资源记录
• 配置的源列表
• 用户偏好设置

开发

环境设置

# 克隆仓库
git clone <repository-url>
cd pilot-cabin

# 安装依赖
npm install

# 开发模式运行
npm run dev

构建

npm run build

测试

# 运行所有测试
npm test

# 运行测试（单次）
npm run test:run

# 类型检查
npm run typecheck

# 代码检查
npm run lint

项目结构

pilot-cabin/
├── src/
│   ├── adapters/       # 资源适配器（安装/卸载逻辑）
│   ├── commands/       # CLI 命令实现
│   ├── core/           # 核心功能（依赖解析、锁文件等）
│   ├── errors/         # 错误类定义
│   ├── sources/        # 源提供者（内置注册表、Git 源）
│   ├── tui/            # 终端用户界面组件
│   ├── types/          # TypeScript 类型定义
│   ├── utils/          # 工具函数
│   └── cli.ts          # CLI 入口
├── registry/           # 内置资源注册表
├── tests/              # 测试文件
└── docs/               # 文档

文档

• 使用指南 - 详细的使用说明和最佳实践
• 架构文档 - 系统架构和设计决策

许可证

MIT