ドキュメント

インストール後の Hangar

Hangar での日々の作業に必要なことをすべてまとめています。最初のエージェントから、Hangar が設定を保存するファイルまで。

最初の手順

  1. インストール。Hangar-Setup.exe をダウンロードして実行します。Hangar は管理者権限なしで、現在のユーザーにのみインストールされます。
  2. エージェントを起動。「新しいセッション」でプロジェクト フォルダーを選び、「プライベート」か「チーム」を選んでエージェントをクリックします。Hangar はこのコンピューターで見つかったすべてのエージェントを、バージョンとともに一覧表示します。「チーム」では、チームセッションとして動作できるものだけが表示されます。
  3. チームを招く (任意)。サイドバー下部の「サインイン」をクリックし、ブラウザーでコードを確認してから、プロジェクトを接続します。同じプロジェクトに参加したメンバーは、チーム ウィンドウでお互いを確認できます。
  4. プロフィール画像(任意)。Hangar アカウントのプロフィール画像はサイドバーに表示されます。このサイトのアカウント › 設定でアップロードします。

Hangar をダウンロード 対応エージェント

インストール中に Windows が SmartScreen の警告を表示した場合は、「詳細情報」を選び、続けて「実行」を選びます。インストーラーにはまだコード署名証明書による署名がありません。Hangar 内での更新は常に署名され、検証されます。

動作環境: Windows 10 バージョン 1809 以降、または Windows 11 (x64)。エージェントは各自のアカウントで別途インストールします。チームセッション (worktree)、変更の追跡、コミット、共有メモには Git が必要です。

キーボード ショートカット

Hangar が受け取るのは、シェルやエージェントが使わない組み合わせだけです。Shift なしの対応するキーはターミナル内のプログラムに渡ります。Ctrl+B、Ctrl+F、Ctrl+P は引き続きシェルやエージェントに届きます。

Hangar 内のどこでも
キー操作
Ctrl+Shift+Pクイック アクセス: セッション、プログラム、ファイル、最近のコミット、設定、すべてのメニュー コマンドを検索
Ctrl+Shift+Sすべてのセッションの出力を検索
Ctrl+Shift+Mすべてのセッションをライブ タイルで表示
Ctrl+Shift+Hホーム表示に切り替え。セッションは動き続けます
Ctrl+Shift+T最後に使ったプログラムで新しいセッションを開始
Ctrl+Shift+Wセッションを閉じる
Ctrl+Tab次のセッション
Ctrl+Shift+Tab前のセッション
Ctrl+Shift+A待機中の次のセッションへ移動
Ctrl+Shift+Nクイックメモ
Ctrl+Shift+Dセッションのフォルダーの変更を表示または非表示
Ctrl+Shift+Fターミナルの履歴を検索
Ctrl+Shift+Bサイドバーを折りたたむ、または展開
Ctrl+,設定を開く
Ctrl++文字を大きく
Ctrl+-文字を小さく
Ctrl+0文字サイズをリセット
ターミナル内
キー操作
Ctrl+C選択範囲をコピー。選択がない場合、キーはプログラムに渡ります (割り込み)
Ctrl+Shift+C選択範囲をコピーし、選択を維持
Ctrl+V貼り付け。クリップボードに画像がある場合、Hangar は保存した画像ファイルのパスを貼り付けます
Shift+Enterエージェントのプロンプトで送信せずに改行する
Ctrl+Shift+スペース押したままで音声入力。音声はお使いの PC 上で認識されます
履歴検索内
キー操作
Enter次の一致
Shift+Enter前の一致
Esc検索を閉じる
メモ、サイドバー、複数のセッションへの送信
キー操作
F6 / Shift+F6メモを開いているとき、ターミナル、メモ一覧、エディターの間でフォーカスを移動
F2メモの名前を変更
Alt+↑ / Alt+↓フォーカスのあるセッションをサイドバー内で上下に移動
Ctrl+Enter複数のセッションにメッセージを送信

profiles.toml のプロファイル

独自のターミナルとエージェントは、構成フォルダー内の profiles.toml に記述します。Windows では %APPDATA%\com.feoren.hangar\profiles.toml です。ファイルがない場合、Hangar は起動時に注釈付きのテンプレートからファイルを作成し、PowerShell 7、Windows PowerShell、コマンド プロンプトを登録します。

ファイルは、設定の「ターミナルとエージェント › プロファイルファイルを開く」から開くのが最も簡単です。

カタログにあるエージェントにはプロファイルは不要で、Hangar が自動的に認識します。そのいずれかを別の方法で起動するには、同じ id のプロファイルを作成します。カタログ項目の名前、アイコン、コマンド、引数、表示位置がそのプロファイルで置き換えられ、プロジェクト ページとインストール コマンドはカタログのものが残ります。

プロファイルのフィールド
フィールド意味
id必須。一意で、スペースを含まない値。大文字と小文字だけが異なる 2 つの ID は Hangar が拒否します。
name必須。サイドバーに表示される名前。
command必須。PATH 上のプログラム名またはフル パス。シェル構文は使えません。Hangar はプログラムを直接起動します。
args引数のリスト。例: ["--model", "opus"]。
cwd固定の作業フォルダー。このフィールドがない場合、プログラムは選択したフォルダーで起動します。
iconサイドバーのアイコンに使う 1 文字または 2 文字。
[profile.env]環境変数を独立したテーブルとして記述します。シークレットはここに書かないでください。
secret_env値を Hangar が Windows 資格情報マネージャーに保管する変数の名前。例: ["GITHUB_TOKEN"]。
resume_args最後の会話を再開するための引数。args に追加されるのではなく、args を置き換えます。
version_argsバージョン確認用の引数。既定値は ["--version"]。[] は、バージョンを読み取るためにプログラムを起動しないことを意味します。
latest, packages, self_update, update_hint新しいバージョンの公開場所と、Hangar がワン クリックでプログラムを更新する方法。ファイル内の注釈付きテンプレートで各フィールドを説明しています。

例

1 つ目のプロファイルは、カタログの Claude Code を別のモデルで起動します。2 つ目は、固定の作業フォルダー、通常の変数 1 つ、シークレット変数 1 つを持つ独自の PowerShell です。

[[profile]]
id = "claude"
name = "Claude Code (Opus)"
command = "claude"
args = ["--model", "opus"]
icon = "C"

[[profile]]
id = "pwsh-shop"
name = "PowerShell (Shop)"
command = "pwsh"
args = ["-NoLogo"]
cwd = 'C:\src\shop'
icon = "SH"
secret_env = ["GITHUB_TOKEN"]

[profile.env]
DOTNET_CLI_TELEMETRY_OPTOUT = "1"

シークレット変数

secret_env の値がファイルに書かれることはありません。値は設定でプロファイルを編集する画面で入力します。Hangar はそれらを Windows 資格情報マネージャーのサービス hangar に保管し、セッションの起動時にだけその環境に渡します。同じ変数を [profile.env] と secret_env の両方に記述することはできません。

保存後、Hangar のウィンドウに戻るとすぐにファイルが再読み込みされます。「プロファイルを再読み込み」を選ぶこともできます。エラーがあれば Hangar は行と列を示し、実行中のセッションはそのまま残ります。

待機中のエージェントの通知

どのエージェントが作業中で、どれが完了し、どれが応答を待っているかがサイドバーで一目でわかります。そのほかの項目はすべて、設定の「通知」にあります。

  • 待機中のセッションを強調表示: 別の場所を見ている間にエージェントが完了するか応答を待つと、セッションが穏やかにパルスします。何秒間動きがなければヒントを表示するかを選べます。
  • 色とパルス: 作業中、完了、質問あり、一時停止のそれぞれに、色、パルスの強さ、パルスの長さを個別に設定でき、プレビューも表示されます。
  • サウンド: 今は見えていないセッションが待機中になると、柔らかい 2 音のチャイムが鳴ります。プログラムがエラーで終了した場合は低い音になります。音量は調整できます。
  • デスクトップ通知: Hangar がバックグラウンドにあるときだけ表示されます。クリックするとそのセッションが開きます。
  • タスクバーを点滅: Hangar が前面にないときだけ点滅します。Hangar のウィンドウに切り替えるとすぐに止まります。
  • タスクバーの件数: タスクバー ボタンの小さなアイコンに、待機中のセッション数が 1 から 9 まで、それ以上は 9+ と表示されます。
  • スマートフォンへのプッシュ: セッションが応答を待つと、ntfy または Pushover で通知します。ntfy では推測されにくいトピックを選んでください。トピックを知っている人は誰でも内容を読めるためです。
  • おやすみ時間: 指定した時間帯は、サウンド、通知、スマートフォンへのプッシュ、タスクバーの点滅がありません。色と待機中のセッション数は表示されたままです。
  • 通知領域で実行を続ける: ウィンドウを閉じてもセッションは動き続け、通知領域のアイコンに待機中の数が表示されます。Hangar を終了するには、アイコンを右クリックします。

Ctrl+Shift+A で、待機中の次のセッションへ直接移動します。

チームセッションと worktree

「新しいセッション」で「プライベート」か「チーム」を選びます。プライベートセッションはフォルダー内で直接、自分だけのために動きます。チームセッションは専用の Git worktree を持ち、チームから見えます。そのため、複数のエージェントが互いのファイルを横取りすることなく、同じプロジェクトを同時に変更できます。

Hangar はチームセッションごとに、現在の状態からブランチ hangar/… を作成します。ほかのセッションが作業中のファイルをエージェントが編集しようとすると、Hangar はそれを止めて確認します。ファイルやフォルダーに「常に許可」または「常に拒否」と答えると、Hangar はプロジェクトごとにそれを記憶します。Claude Code、Codex CLI、OpenCode、Pi はチームセッションとして動作します。

worktree はリポジトリの隣ではなく、アプリのデータ フォルダー内の %LOCALAPPDATA%\com.feoren.hangar\worktrees\ に置かれます。これにより、リポジトリや同期フォルダーがきれいに保たれます。

新しい worktree でエージェントを起動すると、最初にアップストリームの新しいコミットがないか確認し、取り込む前に確認を求めます。この動作は設定の「ターミナルとエージェント」でオフにできます。

チームセッションが終了すると、Hangar は worktree を再び削除します。ただし、変更や、ビルド出力などの無視されたファイルがまだ含まれている場合、またはほかのセッションがまだその中で作業している場合は残します。まだマージされていないコミットを含むブランチも残ります。Hangar が何かを強制することはありません。

Git がインストールされ、フォルダーが Git リポジトリ内にある必要があります。Hangar はネットワーク共有上では Git を実行しません。また、WSL 内では編集前の確認は行われません。

メモ

メモは、セッションのプロジェクトまたは「全般」に属します。実際の Markdown ファイルなので、エクスプローラーで開くこともできます。

  • Ctrl+Shift+N で、どこからでもクイックメモを開始できます。
  • ターミナルで選択したテキストをそのままメモに送ったり、メモをセッションに送ったりできます。送り先では Enter なしで貼り付けられるので、先に内容を確認できます。
  • 削除したメモは「最近削除したメモ」に移り、そこから復元できます。
  • メモパネルの上部で「非公開」と「共有」を切り替えられるので、自分のメモとチームのメモが混ざりません。

暗号化された共有メモ

プロジェクトで共有メモをオンにすると、Hangar はメモを暗号化し、リポジトリの .hangar\notes\ フォルダーに保管します。メモはコミットとともに移動します。リポジトリとコードを持つ人は誰でも読むことができます。復号されたテキストがディスクに書き込まれることはなく、Hangar が自らコミットすることもありません。

オンにすると、Hangar はメモの回復コードを一度だけ表示します。安全に保管してください。このコードがないと、このコンピューターが鍵を失った場合にメモは完全に失われます。コードがあれば、別のクローンでもメモを開けます。

すべてのエージェントに効く 1 つの指示ファイル

HANGAR.md は設定フォルダーの profiles.toml の隣にあり、AGENTS.md や CLAUDE.md と同じように働きますが、リポジトリにファイルを置く必要はありません。Hangar は、追加の指示を受け付けるすべてのエージェント(Claude Code、Codex CLI、Aider)に内容を渡します。初期設定ではオンで、テンプレートは空なので、何か書くまでは何も送られません。

ファイルは、設定の「ターミナルとエージェント」にある「HANGAR.md を開く」から開けます。同じ場所で「すべてのエージェントで HANGAR.md を使う」のオンとオフも切り替えられます。秘密は書かないでください。内容はエージェントのコマンドラインに入ります。

保存場所

Hangar は設定をユーザー プロファイルに保存します。Windows では %APPDATA% と %LOCALAPPDATA% です。プロジェクト内に置かれるのは共有メモだけです。

保存場所
場所内容
%APPDATA%\com.feoren.hangar\profiles.toml独自のプロファイル
%APPDATA%\com.feoren.hangar\HANGAR.mdすべてのエージェントへの指示
%APPDATA%\com.feoren.hangar\account.json選択したサーバーとサインイン済みのサーバー。トークンは含みません
%LOCALAPPDATA%\com.feoren.hangar\workspace.json, scrollback\開いているセッションとその履歴。再起動後に Hangar が復元するために使います
%LOCALAPPDATA%\com.feoren.hangar\notes\プライベート メモ (.md ファイル)。プロジェクト フォルダーごと、および general の下に保存。削除したものは .trash に入ります
%LOCALAPPDATA%\com.feoren.hangar\worktrees\セッションの worktree
%LOCALAPPDATA%\com.feoren.hangar\pastes\貼り付けたスクリーンショット。Hangar が 1 週間後に削除します
%LOCALAPPDATA%\Hangarプログラム本体
.hangar\notes\リポジトリ内の暗号化された共有メモ
Windows 資格情報マネージャーシークレットのプロファイル変数、サインイン情報、チームと共有メモ用の鍵

独自のチーム サーバー

チーム機能では、Hangar は既定で https://hangar.feoren.com/api/v1 の公式サービスに接続します。サインインしなくても、チーム ウィンドウ以外のすべての機能を使えます。

チームが独自の Hangar サーバーを運用している場合は、設定の「アカウント › サーバーアドレス (セルフホスト)」にそのアドレスを入力し、「適用」をクリックします。空欄にすると、再び公式サービスが使われます。

アドレスはサーバーの API ベースです。例: https://team.example.com/api/v1。https:// で始まる必要があります。Hangar が暗号化なしの http を許可するのは localhost、127.0.0.1、[::1] だけです。ユーザー名、パスワード、クエリ、フラグメントは使えません。Hangar はアドレスを account.json に保存します。ほかのサーバーへのサインインはデバイスに保存されたまま残ります。

そのようなサーバーは、公式サービスと同じインターフェイスを提供する必要があります。OAuth デバイス フローによるサインイン、アカウントとプロジェクト、そして WebSocket でチームのデータを運ぶリレー用のチケットです。プロトコルのデータ型と暗号化は、アプリのリポジトリ内のクレート hangar-team-protocol と hangar-team-crypto で、MIT ライセンスのもと公開されています。

チームと共有するものはすべてデバイス上で暗号化されます。サーバーはそれを保存して転送しますが、読むことはできません。新しいデバイスは、誰かが安全番号を照合して確認した後にのみ参加できます。

現在の状況: セルフホスト用の既製サーバー ソフトウェアはまだ公開されていません。アプリでは既に独自のアドレスを使えますが、ここにはまだインストール ガイドがありません。

企業での Hangar 導入を計画していて、独自のサーバーが必要な場合は、ご連絡ください。個別に検討します。

チーム向けのお問い合わせ