Claude Code Tools
为 Claude Code、Codex-CLI 等 CLI 编码智能体提供即装即用的效率工具、插件、钩子与技能集。
仓库可见的证据很少：agent/hook/skill 的实际权限、确认流程、数据流向、敏感数据处理（vault/env-safe 的实现）均只在 README 卡片和外部文档中提及，本仓库内无实现文件可审查，故这些准则只能给 1 分（断言无支持）。依赖安全给 2：CI 使用最小权限声明、Homebrew 更新计算 sha256、构建工具固定版本（hatchling==1.28.0），但 pytest>=9.0.1 被列为运行时依赖（应为开发依赖）且无审计/锁定证据。外部效果给 1：发布流程会写入外部 Homebrew tap 并上传二进制，说明存在外部副作用，但 agent 运行时的副作用面不明。回滚给 1：无任何回滚/恢复机制证据。来源归属给 2：MIT 许可证署名 Prasad Chalasani，但发布者未经验证。
自一致性 2：pyproject 版本 1.27.1 与 commitizen version_files 配置一致，入口点命名统一（aichat 统一会话接口），扣分点是 pytest 列入运行时依赖与工具集定位不符。依赖可用性 2：全部依赖来自 PyPI 且声明了下限，但无锁定文件证据。失败消息 1：仅 visual-brief 的测试助手（laneOf/itemOf 抛出具体错误、storage 拒绝场景测试）显示了对失败路径的思考，产品代码本身的错误处理不可见。
受众与场景 2：明确面向 Claude Code / Codex-CLI 用户的效率工具集，覆盖会话管理、语音、Google 集成等多个场景。能力边界 1：各工具的边界与不适用情形未在源文件中说明。触发精度 1：hook/skill 的触发条件不可见。环境适配 2：requires-python>=3.11，CI 覆盖 Linux/macOS/Windows 多平台多架构，扣分点是大量依赖 tmux、uv、Rust 工具链等外部环境，未见适配说明。
信息架构 2：docs-site 结构清晰、卡片式导航指向各工具页面，但 README 本体几乎不含内容，全部外包给外部站点。安装说明 1：README 内无任何可执行的安装命令，仅靠徽章与外链；pyproject 中的注释（voxtype 需单独安装）是零散补充。命名稳定性 2：命令名（aichat, vault, env-safe 等）与入口点一致且语义明确。示例与 FAQ 1：仓库内仅有 visual-brief 测试样例文档可作示例，无 FAQ。已知局限 1：无局限性说明。许可证 3：完整 MIT 文本、具名版权人，满分。版本与变更日志 2：commitizen 规范提交、tag 格式、version_files 自动同步，但 update_changelog_on_bump=false 表明变更日志非自动维护。维护责任 2：CI/发布/Homebrew 更新自动化完备，但单一未验证维护者的长期责任不可判定。
输出可用性 2：rich、questionary、TUI（rust-search-ui）等表明重视交互体验，但无产品代码可核实输出格式。边际价值 2：工具集覆盖面广（会话迁移、跨 agent 通信 msg、GitHub 唤醒等），解决真实痛点，但个别工具的独特价值无法从源文件验证。成本收益 1：引入大量重量级依赖（discord.py、tantivy、mcp 等）用于一个工具合集，安装面和攻击面都偏大，收益需执行验证。
声明可追溯性 1：README 的功能声明全部指向未提供的外部文档，本仓库内无法追溯验证。跨源印证 1：徽章声称 PyPI 发布、Awesome 列表收录、crates.io 包，均无法在提供的源内印证。事实与推断分离 2：visual-brief 测试数据中明确使用 trust: verified-by-me / unverified / reported-by-agent 标签区分证据等级，显示项目自身有此意识，故给 2；扣分点是 README 层面未做此区分。
- 本审查为静态审查，置信度低：README 的全部功能声明均指向未提供的外部文档，无法在仓库内核实。
- pytest 被列为运行时依赖而非开发依赖，属于依赖分类错误，可能扩大用户安装面。
- 发布流程会自动向外部 Homebrew tap 推送并附带 HOMEBREW_TAP_TOKEN 密钥，企业用户应审查该供应链路径。
- discord.py、tantivy、mcp 等重型依赖对工具合集而言偏重，安装前应评估是否实际需要。
- 无回滚/恢复机制的任何证据，使用 fix-session、session-porting 等修改会话状态的工具前应自行备份。
- 发布者身份未经企业注册库验证，MIT 许可证署名仅提供最低限度的归属信息。
这个 Agent 能做什么，适合哪些场景？
pchalasani/claude-code-tools 是一套面向 CLI 编码智能体的实用工具集合，覆盖 Claude Code、Codex-CLI 及类似工具。它包含多个独立的命令行工具（如 aichat、voxtype、tmux-cli、amux、agent-tunnel、lmsh、vault、env-safe、sasy-guard、statusline、fix-session、github-wake、msg 等），以及技能、智能体、钩子和插件。项目以 Python 包形式发布在 PyPI（claude-code-tools），其中的 aichat-search 组件发布在 crates.io，采用 MIT 许可证。完整文档托管在 pchalasani.github.io/claude-code-tools，涵盖安装步骤、每个工具的说明、插件与使用指南。该项目已被 Awesome Codex CLI 收录，适合希望在终端工作流中增强编码智能体安全性与效率的开发者。
该仓库提供可安装的 CLI 工具与 Claude Code 插件：aichat 支持基于 aichat-search（Rust，crates.io）的聊天检索；voxtype 提供语音输入；tmux-cli 与 amux 处理 tmux 会话与多智能体管理；agent-tunnel 提供隧道能力；vault 与 env-safe 管理密钥与环境变量安全；safety-hooks 与 sasy-guard 提供安全钩子防护；statusline 提供状态栏；fix-session 用于会话修复；session porting 支持 Claude 与 Codex 之间的会话移植；github-watch 支持 GitHub 评论唤醒；msg 提供智能体间通信；另有 Google Docs、Google Sheets 集成与替代 LLM 提供商配置。所有功能通过 CLI 命令或 Claude Code 插件机制部署和调用。
- 使用 Claude Code 的开发者想要安装安全钩子，防止智能体执行危险命令或泄露环境变量（safety-hooks、sasy-guard、env-safe）。
- 同时使用 Claude Code 与 Codex-CLI 的工程师需要在两个工具之间移植会话上下文（session porting 工具）。
- 并行运行多个编码智能体的团队需要用 tmux 管理多个会话（tmux-cli、amux）。
- 偏好语音输入的开发者希望在编码智能体工作流中口述指令（voxtype、voice 插件）。
- 需要监控 GitHub 仓库评论并在收到评论时唤醒智能体的维护者（github-watch）。
- 希望让智能体读写 Google Docs 和 Google Sheets 的用户（gdocs、gsheets 集成）。
这个 Agent 有哪些优点和局限？
- 工具谱系完整：从安全钩子、密钥管理、会话修复到多智能体通信，覆盖编码智能体工作流的多个痛点。
- 同时支持 Claude Code 和 Codex-CLI，并提供两者之间的会话移植能力，降低供应商锁定。
- 发布渠道正规：PyPI 包、crates.io 组件、专门的文档站点，且被 Awesome Codex CLI 收录。
- MIT 许可证，可自由使用与修改。
- 工具数量众多（十余个），逐一评估与集成到现有工作流的成本较高。
- README 是卡片式导航，缺少内联的安装与使用细节，必须跳转到外部文档站点才能上手。
- 部分功能依赖特定运行时：tmux 相关工具需要 tmux，aichat-search 需要 Rust 工具链。
- Google Docs/Sheets 集成和替代 LLM 提供商支持涉及额外的凭据与配置，具体限制文档中才可见。
如何安装或部署这个 Agent？
README 中给出的可复制安装信息有限：核心包通过 PyPI 分发（pip install claude-code-tools 应该可行，badge 指向 pypi.org/project/claude-code-tools），aichat-search 通过 crates.io 分发（cargo install aichat-search）。各工具的具体安装命令、系统依赖和凭据配置未在 README 中给出，需查阅 https://pchalasani.github.io/claude-code-tools/getting-started/ 的快速入门文档。
如何使用这个 Agent？
安装后，各工具以独立 CLI 命令运行（如 aichat、voxtype、tmux-cli、amux、vault、env-safe、statusline、fix-session、msg、github-watch），插件类功能（safety-hooks、voice、visual-brief）通过 Claude Code 插件机制加载。具体的第一条工作命令与参数未在 README 中列出，请参考文档站点的对应工具页面（如 /tools/aichat/、/tools/tmux-cli/）。