mcpField
M
macos-brew

macos-brew

github.com/alphaonedev開発50 回インストール
リポジトリ

macos-brew について

macos-brew は、macOS の Homebrew パッケージ管理を自動化するスキルです。開発環境やスクリプトで使え、formula、cask、サービス、tap、バージョン固定、Brewfile による一括管理に対応します。

主な機能

  1. 01formula のインストール、更新、削除
  2. 02cask による GUI アプリ管理
  3. 03バックグラウンドサービスの制御
  4. 04外部 tap の追加
  5. 05パッケージバージョンの固定
  6. 06Brewfile による環境の再現

活用シーン

  1. 01開発ツールのインストールとバージョン固定
  2. 02アプリ用サービスの起動
  3. 03Brewfile に基づくパッケージ構成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/alphaonedev/openclaw-graph --skill macos-brew

インストール後、Claude Code で/macos-brewを入力して読み込まれたか確認します。

詳細

目的

このスキルは macOS での Homebrew 操作を自動化し、formula、cask、サービス、tap、バージョン固定などのソフトウェアパッケージを効率的に管理できるようにします。/opt/homebrew PATH を介したパッケージのインストール、更新、システム統合など、Homebrew の主要機能に重点を置いています。

使用する場面

スクリプトでの依存関係のインストール、CI/CD パイプラインでのツールの更新、開発環境の設定など、macOS のパッケージ管理タスクでこのスキルを使用します。GUI アプリ向けの cask やカスタムリポジトリ向けの tap など、Homebrew 固有の機能を扱う場合、特に自動化されたワークフローや再現性のあるセットアップを確保する際に適用してください。

主な機能

  • Formula の管理：コマンドラインツールをインストール、アップグレード、削除します（例：brew install wget）。依存関係の解決や、brew pin <formula> を使ったバージョン固定も可能です。
  • Cask の操作：GUI アプリケーションを管理します（例：brew install --cask google-chrome）。依存関係を無視したり、強制的に再インストールしたりするオプションもあります。
  • サービスの制御：バックグラウンドサービスを起動、停止、再起動します（例：brew services start postgresql）。macOS の launchd と連携します。
  • Tap の統合：外部リポジトリを追加します（例：brew tap homebrew/cask）。これにより、コア以外のパッケージを利用できます。
  • PATH と Bundle の管理：スクリプト用に /opt/homebrew を PATH に設定し、brew bundle を使って Brewfile のパッケージ一覧を管理することで、再現性のある環境を構築します。
  • バージョン固定：パッケージのバージョンを固定して更新を防ぎます（例：brew pin node@14）。本番環境の安定性を確保できます。

使用パターン

シェルスクリプトや自動化ツールから brew コマンドを直接呼び出して、このスキルを使用します。まず which brew または command -v brew を使って Homebrew がインストールされていることを必ず確認してください。スクリプトでインストールする場合は、Brewfile を使用します。brew 'git' や cask 'docker' のような行を含むファイルを作成し、brew bundle --file Brewfile を実行します。AI エージェントでは、エラー処理のためにコマンドを try-catch ブロックで囲み、/opt/homebrew/bin を先頭に追加した PATH をエクスポートします。例：bash スクリプトで、次のようにパッケージをインストールして固定します。

brew install node@14
brew pin node@14

別のパターンとして、サービスでは条件チェックと組み合わせ、たとえば起動していない場合にのみ起動します：brew services list | grep -q postgresql || brew services start postgresql。

主なコマンド／API

Homebrew は CLI ベースなので、これらのコマンドをスクリプトから直接使用します。すべてのコマンドは brew <subcommand> [flags] [args] の形式で実行します。

  • Formula のインストール：既存のものを上書きするには brew install <formula> --force を実行します。例：brew install git --force。
  • Cask のインストール：macOS のセキュリティプロンプトをスキップするには brew install --cask <cask> --no-quarantine を実行します。例：brew install --cask visual-studio-code --no-quarantine。
  • パッケージの更新：brew update && brew upgrade <formula> を実行します。固定されたバージョンをアップグレードするには --ignore-pinned を追加します。
  • Tap の管理：Tap を追加するには brew tap <user/repo> を実行します。例：brew tap homebrew/cask-fonts。
  • サービスの操作：brew services start <service> または brew services restart <service> --all を実行します。例：brew services stop redis。
  • Bundle 操作：ファイルからインストールするには brew bundle --file Brewfile を実行します。Brewfile の形式：brew 'package' または cask 'app'。
  • バージョンの固定：固定するには brew pin <formula>、解除するには brew unpin <formula> を実行します。例：brew pin [email protected]。
  • クリーンアップ：古いバージョンを削除するには brew cleanup -s を実行します。アップグレード後は必ず実行してください。

API のように使用する場合は、出力をスクリプトにパイプします。例：インストール済みバージョンを調べるには brew list --versions | grep node を実行します。

統合に関する注意事項

スクリプトに Homebrew を統合するには、/opt/homebrew/bin が PATH に含まれていることを確認します。.zshrc またはスクリプトに export PATH="/opt/homebrew/bin:$PATH" を追加してください。CI/CD（GitHub Actions など）では、まず /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" で Homebrew をインストールします。認証は不要ですが、プライベートな tap に拡張する場合は、export HOMEBREW_GIT_EMAIL="[email protected]" のような環境変数を使って Git 認証情報を設定してください。他のツールとの統合では、macOS ツールと組み合わせます。たとえば、brew install ffmpeg の後、Python スクリプトから subprocess を使って実行できます。Brewfile の設定形式はプレーンテキストで、brew 'jq' # JSON processor のような行を記述します。複雑な操作の前には、必ず brew --version で Homebrew のバージョンを確認してください。

エラー処理

よくあるエラーに対処するには、終了コードを確認します。brew コマンドは失敗すると 0 以外の値を返します。「formula not found」の場合は、まず brew search <formula> を実行するか、brew install <formula> 2>/dev/null || echo "Error: Formula missing" でインストールしてください。「Permission denied」の場合は、sudo を使って実行するか、/opt/homebrew の所有者を修正します（例：sudo chown -R $(whoami) /opt/homebrew）。brew update 中にネットワークの問題が発生した場合は、brew update --verbose で再試行し、接続を確認してください。スクリプトでは、次のようにコマンドをラップします。

if ! brew install git; then
  echo "Installation failed; check logs" >&2
  exit 1
fi

brew install <formula> >> install.log 2>&1 で出力をログに記録します。バージョンの競合は、brew doctor で診断して解決してください。

具体的な使用例

  1. 開発ツールをインストールして固定する：特定の Node.js バージョンでプロジェクトをセットアップするには、brew install node@14 を実行し、続けて brew pin node@14 を実行します。これによりバージョンの自動更新が防止され、一貫性を保てます。

  2. Web アプリのサービスを管理する：Redis を利用するアプリでは、brew services start redis でサービスを起動し、brew services list | grep redis で確認します。失敗した場合は、brew doctor で確認して再起動してください。

グラフの関連性

  • macOS の幅広いツール群に関連する「macos」クラスターに接続されています。
  • 「packages」タグに関連付けられており、apt や yum などの一般的なパッケージマネージャーへのリンクがあります。
  • 「homebrew」タグに関連付けられており、エコシステム内の高度なスクリプト作成ツールや CI ツールへのリンクが考えられます。

コメント

Markdown 対応