$ cat ~/map/vstack.md
vstack
面向 AI 编程 agent 的跨工具包管理器，统一管理技能、扩展与钩子，原生支持 Pi。
tools✓ 10月16日
事实速查
- GitHub Stars
- ★ 83
- Forks
- 34
- 许可证
- MIT
- npm / 月
- —
- 最后推送
- 2026年10月16日
安装
curl -fsSL https://kendex.ai/install.sh | sh## 速览
AI 编程 agent 定制内容的跨工具管理器——一个应用加 CLI（项目现已更名为 kendex），技能、agent、钩子与 pi 扩展只装一次，即可落到 Claude Code、Codex、OpenCode、Cursor、pi、Gemini CLI 与 GitHub Copilot 各自正确的位置。
## 要点
- $桌面应用与 CLI 共用一个引擎：技能、agent 或钩子装一次就会落到每个工具对应的正确位置；agent 或技能只写一个文件，各工具自己的格式由它生成；每次变更先预览再执行，事后可撤销。
- $支持七个 harness——Claude Code、Codex、OpenCode、Cursor（仅项目级）、pi、Gemini CLI 与 GitHub Copilot。对 pi 管理的是 agents、skills、hooks 与 pi 扩展（npm 包，复制后注册）；commands 仅只读展示，MCP 服务器与 plugins 在 pi 上没有可管理的面。
- $四个动词、顺序固定：scan（只读盘点）、在一份 kendex.toml 里声明所需、diff 比对期望与实际（Sync 页面）、带预览地事务式 apply——锁文件记录每个安装项的来源与内容指纹。
- $所有权规则：你设置的值绝不被覆盖，你删掉的值绝不被加回；kendex 没创建过的文件只会上报、绝不删除；删掉任何 kendex 生成的内容都安全——下一次 apply 会按 kendex.toml 重建。
- $kendex.ai 社区市场：订阅任意技能 git 仓库并从中安装、发布自己的包，或通过一个链接安装共享合集；过期视图跨所有工具汇总待更新项，并可一步修复。
- $CLI 覆盖 add/remove/adopt/apply/refresh、verify（漂移检查，失败即非零退出）、list/check、source 与 project 注册表、marketplace 命令、作用域（--scope project|global|all）以及 update/update-pi；该仓库本身就是默认目录。
## 常见问题
Q 仓库叫 vstack，为什么到处都是 kendex？
github.com/vanillagreencom/vstack 上的项目现已更名为 kendex——README、CLI、安装命令与社区站点（kendex.ai）都用 kendex 之名，macOS/Linux 的安装包也以它命名。
Q 在这里管理的 pi hooks 真的会执行吗？
kendex 会像管理其他面一样在两个作用域管理 pi hooks，但真正让 pi 执行它们的是 pi-hooks 扩展——没有注册该扩展时，这些 hooks 只是 pi 可以忽略的指令。
Q 怎么安装？
curl -fsSL https://kendex.ai/install.sh | sh 会同时安装应用与 CLI。macOS 可用 brew install vanillagreencom/kendex/kendex 装应用（仅 CLI 用 kendex-cli tap），Arch 用 yay -S kendex-bin，Windows 从 kendex.ai/download 下载安装器。
## 参考链接
## 相关条目
最后更新: 2026年8月31日