mcpField
G
ghgrab

ghgrab

github.com/akillness开发53250 次安装4 天前更新
代码仓库

关于 ghgrab

ghgrab 是用于在命令行中从 GitHub 按需获取文件、文件夹和发布资产的技能，支持交互式浏览仓库，适合单次提取而无需完整克隆。

主要功能

  1. 01浏览和搜索仓库目录
  2. 02选择文件或文件夹下载
  3. 03获取 GitHub 发布资产
  4. 04写入前确认目标路径

适用场景

  1. 01无需克隆仓库即可下载少量文件
  2. 02通过交互式命令行导航查找文件
  3. 03选择适用于特定平台的发布二进制文件
  4. 04将所选文件保存到指定工作目录

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/akillness/jeo-skills --skill ghgrab

安装后在 Claude Code 中输入/ghgrab确认已加载。

附带文件evals/evals.jsonSKILL.toon

详细介绍

ghgrab

当用户需要在终端工作流中快速获取 GitHub 上指定的文件、文件夹或发布资源时，使用此技能。

适用场景

  • “我只想从 GitHub 获取几个文件”
  • 一次性提取内容时，完整克隆过于繁重
  • 需要通过命令行交互式浏览或搜索仓库
  • 需要下载发布资源，不想使用浏览器

操作说明

步骤 1：确认是否可用以及安装路径
command -v ghgrab || true

如果尚未安装，请选择一种安装方式：

# npm
npm install -g @ghgrab/ghgrab

# cargo
cargo install ghgrab

# pipx
pipx install ghgrab

然后验证：

ghgrab --help
步骤 2：以交互模式启动，或直接打开目标仓库
# interactive home
ghgrab

# open repo directly
ghgrab https://github.com/OWNER/REPO
步骤 3：使用选择性下载流程
  • 在仓库树中浏览或搜索
  • 仅选择所需的文件或文件夹
  • 下载到当前工作目录（或工具提示词指定的目标位置）
  • 优先选择少量且明确的内容，避免批量拉取
步骤 4：发布资源模式

当用户需要 GitHub Releases 中的二进制资源时，使用 ghgrab 的发布资源选择模式（如果工具提供，请使用适用于操作系统/架构的选项）。

步骤 5：自动化防护措施
  • 写入文件前确认目标路径
  • 不确定时优先使用非破坏性路径（新文件夹）
  • 在运行记录中记下所选的源仓库和目标位置，以便复现

示例

# Browse then cherry-pick files
ghgrab https://github.com/rust-lang/rust

# Start home and search repos interactively
ghgrab

注意事项

  • 安装多个包管理器变体可能会导致二进制文件路径被覆盖；请检查 which ghgrab。
  • 私有仓库需要有效的 GitHub 身份验证/会话上下文。
  • 避免将 ghgrab 用作完整仓库历史操作的替代方案（需要操作历史记录或分支时，请使用 git clone）。

评论

支持 Markdown