Skip to content
Spoon94Public

About

A small zoo of shell tools for AI-coding workflows — one script per tool, symlink-installed. otter: tmux session layout. wren: two-line statusline for Claude Code & pi.

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Repository files navigation

cli-zoo

License: MIT GitHub Stars Shell: Bash PRs Welcome

个人收藏并整理的命令行小工具集合,按工具拆分目录组织,开箱即用。

每个工具存放在 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 复制文件副本到宿主。安装完成后,宿主不再依赖本仓库的位置。

wren 概览

wren statusline 预览(上:宽档;下:窄档)

终端宽 ≥ 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。

License

MIT

About

A small zoo of shell tools for AI-coding workflows — one script per tool, symlink-installed. otter: tmux session layout. wren: two-line statusline for Claude Code & pi.

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages