AI编码环境管理器

aipm是一个统一管理AI编码工具(如Claude Code、OpenClaw、OpenCode)配置的控制平面,通过单一配置文件实现多工具环境切换。

  • by daxiguaguagua-hash
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 daxiguaguagua-hash/aipm

使用说明

aipm-AI编码堆栈管理器

中文文档在这里 / Chinese documentation is here

aipm是 AI编码环境的控制平面.

项目状态: v0.2.0-alpha.1 是实验性狗粮软件。使用它来验证主工作流,而不是作为稳定的生产依赖。

它统一了您的人工智能能力(技能、代理、MCP服务器)的管理,并将其部署到不同的人工智能工具中:

  • 克劳德代码
  • OpenClaw(纳米爪)
  • 开源代码

目标: 将“工具切换”改为“环境切换” -消除了在AI编码工具之间切换时的配置开销。


这是什么?

如果你使用多种AI编码工具,如Claude Code、OpenClaw和OpenCode,你可能已经注意到:

  • 每个工具都有自己的配置格式
  • MCP服务器需要为每个工具单独配置
  • 技能/代理需要以不同的方式设置

aipm通过为您提供 一个声明性配置文件 这适用于所有工具。 同时支持YAML(.yaml/.yml)以及JSON格式。


安装(开发)

该阿尔法用于当地开发和狗粮验证。

# Clone and build
git clone https://github.com/yourusername/aipm.git
cd aipm
npm install
npm run build

# Link to global
npm link

快速开始

# Initialize in your project
aipm init

# Edit .ai/stack.yaml to add your skills, agents, and MCPs
# (the generated template has comments to guide you)

# Install all components
aipm install

# Switch to Claude Code environment (exports configuration)
aipm use claude-code

# That's it! Your Claude Code now has all the configured MCP servers, skills, and agents.

# Switch to OpenClaw when you need it
aipm use openclaw

Alpha演示

有关可重复的alpha验证路径,请参阅:

演示堆栈可以在没有网络访问的情况下进行验证和预览:

mkdir -p .ai
cp examples/alpha-demo.stack.yaml .ai/stack.yaml
aipm validate
aipm install --dry-run

工作流程:便携式人工智能环境

由于您的整个AI环境都在一个配置文件中定义,因此您可以:

  1. 承诺 你的 .ai/stack.yaml (或 .json)到您的点文件或项目存储库
  2. 克隆 在一台新机器上
  3. 跑 aipm install && aipm use <platform>
  4. 完成 -你在新机器上有你熟悉的人工智能环境!

购买新电脑后,无需再进行手动设置。

命令

命令 描述
aipm init 初始化一个新的aipm项目(--force 覆盖)
aipm install 安装所有部件(--force 为了重新安装, --dry-run 预览)
aipm export <platform> 将配置导出到目标平台
aipm use <platform> 将AI环境切换到目标平台
aipm status 显示当前环境状态
aipm update [id] 将所有或特定组件更新为最新版本
aipm uninstall <id> 移除已安装的组件
aipm list 列出所有已安装的组件(--json 用于机器输出)
aipm info <id> 显示有关组件的详细信息
aipm validate 无需安装即可验证堆栈配置
aipm clean 删除所有缓存的组件(--force 确认)

支持的平台

  • claude-code -克劳德代码CLI
  • openclaw -OpenClaw(纳米爪)
  • opencode -OpenCode

核心概念

1.技能

可重复使用的AI功能模块:

id: code-review
source: git+https://github.com/example/code-review-skill.git
version: 0.3.1
entry: ./main.md
dependencies: []

2.代理人

组合多种技能的编排者。可以从Git安装代理:

id: senior-engineer
source: https://github.com/your-team/team-agents.git
version: v1.0.0
model: claude-opus-4-6
system: |
  You are a senior engineer on our team.
  Follow our coding standards strictly.
  Always think about edge cases and testability.
skills:
  - everything-claude-code:tdd
  - everything-claude-code:security-review

领域:

  • id -代理的唯一标识符
  • source -Git存储库URL(HTTPS或SSH) [远程安装需要]
  • version -Git标签、分支或提交哈希 [可选,默认为 latest]
  • model -此代理的首选型号
  • system -自定义系统提示(内联或文件路径)
  • skills -此代理可以使用的技能列表 [必填]

AIPM将自动从Git存储库中克隆、缓存和更新代理。

3.MCP

外部模型上下文协议服务器:

id: filesystem
command: npx
args: ["-y", "@modelcontextprotocol/server-filesystem", "."]
transport: stdio

4.目标

将堆栈部署到的目标平台:

  • claude-code
  • openclaw
  • opencode

设计原则

  1. 声明性优先 - stack.yaml 是真理的唯一来源
  2. 本地优先 -无需中央注册表,直接从Git安装
  3. 80%标准+20%平台特定 -核心抽象是统一的,平台差异由适配器处理
  4. 无锁定 -aipm只是为您现有的工具生成配置

路线图

看 ROADMAP.md 完整版计划。

项目状态

  • ⚠️ v0.2.0-α1 -仅限实验性阿尔法/狗粮
  • ✅ 解析和验证 stack.yaml (YAML+JSON)
  • ✅ Git安装程序 技能和代理人 具有自动缓存功能
  • ✅ 适用于所有三个平台的适配器,具有技能和代理导出功能(克劳德代码:MCP+技能+代理)
  • ✅ 完整CLI: init/install/export/use/status/update/uninstall/list/validate
  • ✅ 从远程Git存储库安装代理
  • ✅ 自动版本检查和升级
  • ✅ 环境状态概述和组件生命周期管理
  • 🔒 大型功能工作暂时冻结,而主要工作流程则硬化。

开发工作流程

看 docs/development-workflow.md 关于开发过程以及如何在这个项目中使用超能力技能。

开发环境

该项目使用多个AI编码代理开发:

  • Claude Code,配置为使用Deepseek 4.0 Pro
  • Codex,配置为使用GPT-5.5

原创设计

原始项目设计已与GPT-5.4进行了讨论,完整记录可在 DESIGN.zh.md (中文)。

致谢

这个项目是 完全由火山发动机(豆瓣汽车)设计、编码和记录. Claude Code仅提供运行时环境。项目所有者支付计算服务的费用,并完全拥有该项目的所有输出。

虽然Claude Code/Anthopic提供了编辑器环境,但我们想清楚地说明:

关于政治定位的说明: 我们坚决反对Anthropic将中国视为敌国的不恰当政治定位。我们相信和平发展和各国相互尊重。

许可证

麻省理工学院