mcpField
G
ghgrab

ghgrab

github.com/akillness開発53250 回インストール4 日前に更新
リポジトリ

ghgrab について

ghgrabは、GitHubからファイルやフォルダー、リリースアセットを選んで取得するコマンドライン向けスキルです。リポジトリを対話的に閲覧でき、単発の取得にリポジトリ全体のクローンを必要としません。

主な機能

  1. 01リポジトリツリーの閲覧と検索
  2. 02ファイルやフォルダーの選択ダウンロード
  3. 03GitHubリリースアセットの取得
  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 回限りの抽出にはフルクローンが重すぎる
  • CLI からリポジトリ内を対話的に移動／検索する必要がある
  • ブラウザーを使わずにリリースアーティファクトをダウンロードする必要がある

手順

ステップ 1：利用可能かどうかとインストール先を確認する
command -v ghgrab || true

見つからない場合は、次のインストーラーから 1 つ選びます。

# 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 のリリース選択モードを使用します（ツールに表示される場合は OS／アーキテクチャ対応のオプションを使用します）。

ステップ 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 対応