我做了一个小 CLI:oag,给经常折腾 AI 配置的开发者

导语摘要

如果你也在用 Claude、Codex,可能遇到过这些事:换台电脑要重配、同事发来一堆配置文件不知道怎么落、某个好用的 skill 更新后大家版本不一致。oag 是我为这类问题做的一个小工具:把 AI 资产放进 Git 注册表里,再通过 CLI 做安装、模板应用和更新同步。它不神奇,但能把很多重复动作变简单。


先说结论:oag 不是"大而全平台",它就是一个命令行工具,专门解决一件事------让 AI 资产(agent/skill/mcp)在本地项目里更好管一点。

我自己之前经常踩这些坑:

  • 新项目里要把一堆 AI 配置重新拷一遍;
  • 同一个团队里每个人本地配置都不太一样;
  • 有人改了常用 skill,别人还在用旧版;
  • Claude 和 Codex 的配置文件格式不一样,来回对齐很烦。

如果你也有类似体验,oag 可能刚好能帮上忙。

oag 是什么

oag 是一个用于管理 Git 注册表里 AI 资产的 CLI。你可以把它理解成"AI 资产的安装器 + 同步器"。

它目前做的事情很朴素:

  • 连接远程注册表仓库;
  • 在读取/安装前自动同步注册表;
  • 交互式选择要启用的资产;
  • 用 preset 快速套用一组常用配置;
  • 根据项目记录的状态执行后续更新;
  • 处理 Claude 与 Codex 的 MCP 配置格式。

没有很玄学的功能,主要目标就是少折腾、少手工、少不一致。

我觉得比较实用的 4 个点

1)先同步再操作,避免"我这边不是最新"

list、install、preset、update 前会先做注册表同步。这样你看到的资产列表通常就是当前仓库状态,不容易出现"你我看到的不是一份东西"。

2)install 适合第一次接入

可以按工具(比如 codex)交互式启用资产,第一次落地比手工复制文件稳很多。

3)preset 适合复用一套配置组合

你已经有一套"平时最好用"的组合时,做成 preset 后,新项目可以直接应用,不用每次重新选。

4)update 适合长期维护

很多工具第一次安装都不难,难的是后续更新。oag update 会基于项目记录过的资产做重装/更新,这点对长期使用更有价值。

快速试一遍(可直接复制)

bash 复制代码
npm install -g @wrenfix/oag
oag --help
bash 复制代码
oag remote add https://github.com/wrenfix/oag.git main #仅试用,正式使用需要自己fork出自己团队的资产仓库
bash 复制代码
oag list
oag list-presets
bash 复制代码
oag install
bash 复制代码
oag preset
bash 复制代码
oag update

适合什么场景,不适合什么场景

我自己的判断(供参考):

比较适合:

  • 经常在多个项目间切换 AI 配置;
  • 团队里有共享 mcp/skill/agent 的需求;
  • 希望把资产版本放到 Git 里管理。

可能不太适合:

  • 你只在单机、单项目里偶尔用一次 AI 工具;
  • 你完全不想维护任何注册表仓库。

最后

这篇不是"万能工具安利",更像是一个开发者踩坑后的整理:如果你正好也被 AI 配置同步这件事折腾过,欢迎试试 oag。

如果不好用,也欢迎直接提 issue 或建议;如果对你有帮助,那就太好了。

bash 复制代码
npm install -g @wrenfix/oag
oag remote add https://github.com/<you>/<your-registry>.git main
oag install

项目地址:github.com/wrenfix/oag

如果这篇文章或 oag 对你有一点帮助,欢迎点个 Star 支持一下 🙌

相关推荐
wflynn20 小时前
GitHub 今日推荐|rust-anything:录制真实输入输出,渐进式重写热点函数到 Rust
rust·开源·github·cli·claude-code·agent-skills
wflynn21 小时前
GitHub 日榜趋势速报 | 2026-11-17
开源·github
一只爱撸猫的程序猿1 天前
五周、两个开源仓库、九次拦截之后:AI 时代程序员缺的到底是什么
人工智能·后端·开源
ClouGence1 天前
DBeaver太重,Navicat付费?试试这4款好用的开源数据库管理工具!
数据库·开源
分布式存储与RustFS1 天前
RustFS 分片上传怎么配:大文件断点续传的最小可验证流程
运维·云原生·开源·对象存储·分布式存储·s3·性能基准
孟健2 天前
用 HyperFrames 解决前端视频生成难题:国产 Flash 模型实测 3 条 1080p 视频
前端·人工智能·开源
分布式存储与RustFS2 天前
Rivet 的 Agent 状态存进自建 RustFS:主桶配置与上线边界
运维·云原生·开源·对象存储·分布式存储·s3·性能基准
量子客2 天前
IBM、AMD正式开源「量子纠错解码评估框架」,突破多GPU调度,量子解码吞吐量提升达7.5 倍
开源·量子计算
feasibility.2 天前
399美元桌面机器人Doly:可爱电子宠物+树莓派开源平台,但不能像ChatGPT那样聊天
机器人·开源·嵌入式·树莓派·diy·桌宠
翼帆2 天前
我用 AI 复刻了 CodeTank,重温代码坦克
前端·javascript·开源·ai编程·游戏开发·codetank