はじめに

クイックスタート

Hyla をインストールしてプロジェクトを開き、終了しても動き続けるセッションで最初のエージェントを動かしましょう。

インストール

リリースページから最新の Hyla をダウンロードします。macOS では Hyla.app を“アプリケーション”フォルダにドラッグします。Windows では Hyla Setup インストーラを実行します。管理者権限は不要です。

Homebrew でも入ります。チップに合わせて Apple Silicon か Intel のディスクイメージを取ります:

sh
brew tap smallnest/hyla
brew trust smallnest/hyla
brew install --cask hyla

この cask は独自の tap にあり、Homebrew 7 は homebrew-cask 以外の tap を一度だけ信頼するよう求めます。brew trust がそれです。

Windows では、セッションは PowerShell 7 がインストールされていればそれで、なければ Windows PowerShell で動きます。cmd や Git Bash の bash など別のシェルは、設定 › シェルで選べます。疑似コンソールを使うため、Hyla には Windows 10 1809 以降が必要です。

コマンドラインツールのインストール

Hyla › コマンドラインツールをインストール… を選ぶと、hyla が PATH に入ります: macOS では /usr/local/bin に、Linux では ~/.local/bin にリンクが作られ、Windows では Hyla の bin フォルダがユーザーの PATH に追加されます(それ以降に開いたターミナルで有効)。どのターミナルでも、次のコマンドで確認できます:

sh
hyla help

ターミナルで hyla とだけ入力すると、アプリが開きます。

プロジェクトを開く

⌘ O を押してフォルダを選びます。Hyla はそれをプロジェクトとしてサイドバーに追加し、そこでセッションを開きます。

コマンドラインから始めることもできます。新しいセッションは、そのディレクトリに合うプロジェクトに入ります:

sh
cd ~/code/my-app
hyla new --focus

エージェントを始める

ほかのターミナルと同じように、セッションでエージェントを実行します:

sh
claude

あるいは、サイドバーで見分けやすい名前を付けて、専用のセッションを与えます:

sh
hyla new -n fix-login -- claude

エージェントが作業している間、そのセッションは作業中と表示されます。何かを尋ねるために止まると待機中に変わり、Hyla が通知します。⌘ J でそこへ移動できます。

何も失わずに終了する

⌘ Q を押します。セッションは hylad の中で動き続けます。もう一度 Hyla を開けば、スクロールバックも含めてすべてそろっています。

次のステップ

  • ペイン: セッションを分割して、エージェントの横で開発サーバーを動かす
  • コーディングエージェント: hyla skill setup を実行して、エージェントに Hyla の使い方を覚えさせる