Local Tool Finder

本地 CLI 工具知识库 / 工具发现器。它扫描本机 Homebrew 已安装工具，读取 brew 描述、实际命令、man 文档和 --help 摘要，生成本地 JSON 缓存，然后支持用中文或英文搜索“我本机有什么命令可以做这件事”。

快速开始

npm install -g .
toolfind scan
toolfind search "json 格式化"
tf "查看目录大小"
toolfind show jq
toolfind examples jq

不想全局安装时，也可以直接运行：

node bin/toolfind.js scan
node bin/toolfind.js search "http 请求"

默认缓存位置：

~/.toolfind/index.json

toolfind 不会在搜索时自动扫描，也不会做实时后台扫描。需要刷新数据时，手动运行：

toolfind scan

扫描过程中会在命令行输出进度日志，包括发现的 formula 数量、每个 formula 的处理状态、跳过原因和缓存写入位置。

可以用 TOOLFIND_HOME 改到其他目录：

TOOLFIND_HOME=/tmp/toolfind toolfind scan

命令

toolfind scan [--all] [--no-man] [--limit N]
toolfind search <query>
toolfind <query>
toolfind show <command>
toolfind examples <command>
toolfind doctor

• scan: 扫描 brew leaves，生成索引。
• scan --all: 扫描所有 brew formula，包含依赖。
• scan --no-man: 跳过 man/help 增强，只用 brew 元数据。
• search: 搜索本地缓存。
• show: 查看某个命令的详细索引信息。
• examples: 查看命令示例。
• doctor: 检查 brew、man、col 和缓存状态。

设计文档

见 docs/implementation.md。