个人收藏并整理的命令行小工具集合,按工具拆分目录组织,开箱即用。
每个工具存放在 zoo-scripts/<动物名> 下(单脚本或多文件目录均可,入口可直接执行),通过仓库根目录的 cli-zoo-install.sh 软链到 $PREFIX(默认 /usr/local/bin)即可全局使用。
以安装 otter 为例:
# 1. 克隆本仓库
git clone https://github.com/Spoon94/cli-zoo.git
cd cli-zoo
# 2. 安装 otter 到 /usr/local/bin(可能需要 sudo)
./cli-zoo-install.sh otter
# 3. 验证
otter -h不想动 /usr/local/bin 时,可用 PREFIX 指定任意可写目录:
PREFIX=$HOME/bin ./cli-zoo-install.sh otter用 tmux 把 AI CLI 工具、文件管理器、编辑器、git 客户端组合成一套开箱即用的开发会话布局,一条命令进入工作状态。
otter -c <tool> [-s <session>] # 启动或复用一个 session
otter -ks <session> # 杀掉指定 session
otter -h # 帮助-c 可选值(白名单 ALLOWED_TOOLS):claude、qodercli、opencode。布局为左 CLI 工具 + 右上 yazi + 右下空 shell,检测到 nvim / lazygit 时各开一个 window;软依赖缺失自动降级。
wren 把两行 statusline(Dracula 配色)装到 4 个宿主:Claude Code、pi、Qoder CLI、opencode。 wren 复制文件副本到宿主。安装完成后,宿主不再依赖本仓库的位置。
终端宽 ≥ 56 列时,wren 渲染宽档。终端宽 ≤ 55 列时,cc 与 pi 渲染窄档。
窄档用 3 类图标:◈ 缓存命中率、▂▄▆█ 上下文占用四分位、⏱ 首片延迟。
窄档覆盖 2 个宿主。qc 拿不到终端宽,oc 暂不实现。
./cli-zoo-install.sh wren # 第一步:把 wren 装到 $PREFIX
wren install [cc|pi|qc|oc|all] # 装到宿主。默认 all。幂等。别名:claude、qoder、opencode
wren uninstall [cc|pi|qc|oc|all] # 卸载。默认 all
wren -h # 显示帮助四个宿主的差异、安装器细节、完整参数,见 zoo-scripts/wren/README.md;测试见 docs/testing.md。
./cli-zoo-install.sh <tool> # <tool> 可选值:otter、wren
./cli-zoo-uninstall.sh <tool> # 幂等:目标不存在时直接成功 exit 0| 环境变量 | 默认值 | 说明 |
|---|---|---|
PREFIX |
/usr/local/bin |
软链目标目录。目录不存在时会自动 mkdir -p。 |
安装时检查源脚本存在且可执行(必要时 chmod +x),目标位置已有文件或软链则先 rm -f,再 ln -s <repo>/zoo-scripts/<tool> $PREFIX/<tool>(wren 因是多文件工具,软链的是目录内的入口脚本 zoo-scripts/wren/wren)。写入失败(权限不足)时会提示用 sudo PREFIX=$PREFIX ./cli-zoo-install.sh <tool> 重试。
wren 的两级安装是刻意的:
cli-zoo-install.sh装的$PREFIX/wren是软链(跟随仓库,改脚本即时生效); 而wren install装到宿主的<settings.json 同目录>/wren-cc/$PI_EXT_DIR/wren-pi.ts/$QODER_CONFIG_DIR/wren-qc.py/<tui.json 同目录>/plugins/wren-oc.tsx是文件副本(仓库被移走/删除后 statusline 照常工作,更新需重跑wren install)。
wren 卸载要先拆线再卸本体,否则会留下 ~/.claude/wren-cc、两份 settings.json 里的 statusLine、pi 扩展目录里的 wren-pi.ts、
~/.qoder/wren-qc.py、以及 opencode 的 payload 与 tui.json 里的 plugin 条目:
wren uninstall # 拆掉四个宿主的接线
./cli-zoo-uninstall.sh wren # 再摘掉 wren 本体欢迎 PR 和 Issue:
- 新增工具:把脚本放到
zoo-scripts/,在本 README「工具列表」中追加一节,并配套补齐cli-zoo-install.sh/cli-zoo-uninstall.sh的case分支与测试用例(见 docs/testing.md)。 - 修复/改进现有工具:建议先在 Issue 中讨论后再提 PR。
- 提交规范:建议遵循 Conventional Commits。