csansoon/hostel-install

Hostel CLI のインストールと接続

hostel バイナリは、人、エージェント、サーバ、ルームマシンで共通です。このスキルは、人のコンピュータにインストールし、そのコンピュータをサーバに接続します。サーバマシンについては hostel-server-setup、ルームマシンについては hostel-rooms を参照してください。

macOS および Linux

curl -fsSL https://raw.githubusercontent.com/csansoon/hostel/main/install.sh | sh

このスクリプトは最新の GitHub リリースをダウンロードし、リリースの SHA256SUMS に対してファイルをチェックし、hostel を ~/.local/bin にインストールします。

オプション（sh -s -- の後に指定）:

オプション	効果
--dir DIR	バイナリを DIR にインストール（デフォルト: ~/.local/bin）。
--version vX.Y.Z	このリリースをインストール（デフォルト: 最新）。
--server DIR	ルームバイナリを DIR/helpers に、プラットフォームスクリプトを DIR/platforms にインストール（サーバマシン専用）。

例:

curl -fsSL https://raw.githubusercontent.com/csansoon/hostel/main/install.sh | sh -s -- --dir /usr/local/bin
curl -fsSL https://raw.githubusercontent.com/csansoon/hostel/main/install.sh | sh -s -- --version v0.1.0

スクリプトが note: ... is not on your PATH と表示した場合、シェルプロファイルでディレクトリを PATH に追加してください。例:

export PATH="$HOME/.local/bin:$PATH"

対応環境: macOS および Linux（amd64 または arm64）。環境変数 HOSTEL_INSTALL_URL でダウンロード URL を置き換えることができます（ミラー用）。

Windows

PowerShell で（管理者権限は不要）:

irm https://raw.githubusercontent.com/csansoon/hostel/main/install.ps1 | iex

このスクリプトは hostel.exe を %LOCALAPPDATA%\Programs\hostel にインストールし、SHA256SUMS と照合し、そのディレクトリをユーザーの PATH に追加します。初回インストール後は新しいターミナルを開いてください。$env:HOSTEL_VERSION（例: v0.1.0）でリリースを選択できます。$env:HOSTEL_INSTALL_URL でミラーを設定できます。

注: install.ps1 は新しいスクリプトです。失敗した場合は、GitHub リリースから hostel-windows-amd64.exe（または -arm64.exe）をダウンロードし、hostel.exe にリネームして PATH が通ったディレクトリに配置してください。

インストールの確認

hostel --version
hostel help

コンピュータをサーバに接続する

サーバの管理者から招待コード（hostel1-...）を渡されます。これは一度だけ、24時間有効です。管理者が招待コードを作成する方法については hostel-users を参照してください。

hostel connect hostel1-...
hostel connect hostel1-... --name "Alice Example"

• デフォルトの名前は git config user.name から取得されます。ターミナルでは、connect が入力を求めます。
• 出力には、サーバ、固定された TLS キー（独自の証明書を持つサーバの場合）、ユーザーのロール、コンピュータ名が表示されます。
• 接続情報は ~/.config/hostel/config.toml（モード 0600）に保存されます。Windows の場合は %USERPROFILE% 配下の同じ場所になります。
• 各コンピュータは最大 1 つの接続を持ちます。既存の接続がある場合、connect は置き換える前に確認を求めます。--yes を指定すると確認なしで置き換えます。
• このコンピュータ上のエージェントは同じ接続を使用します。エージェントが個別の接続を持つ必要はありません。

確認:

hostel status

切断（サーバがこのコンピュータのトークンを削除します）:

hostel disconnect

テストや CI 用に、環境変数 HOSTEL_SERVER、HOSTEL_TOKEN、HOSTEL_SERVER_KEY でファイルの設定を上書きできます。

Hostel アプリ

ターミナルで hostel を引数なしで実行します。フルスクリーンアプリが起動します。

• 未接続: チェックイン（招待コードをペーストし、名前を入力）または退出。
• ロビー: プラットフォーム、その空きマシン、キュー、待機状況。
• ルーム: マシン、その状態、誰が使用しているか。
• フロントデスク: サーバと自分自身；ゲストを招待（管理者）、他のコンピュータを追加（メンバー）、ゲストリスト、ルームを追加（管理者）、チェックアウト（切断）。

キー: 1 2 3 でロビー、ルーム、フロントデスクに移動；? で全キー一覧表示；q で終了。NO_COLOR=1 で色をオフにします。ターミナルがない場合（エージェント、パイプ）、hostel は代わりにヘルプを表示します。エージェントは hostel status（プレーンテキスト）を使用します。

更新

同じインストールコマンドを再度実行してください。バイナリが置き換えられます。

curl -fsSL https://raw.githubusercontent.com/csansoon/hostel/main/install.sh | sh
hostel --version

Windows の場合は、irm ... | iex の行を再度実行してください。接続は維持されます。

サーバマシンの場合、更新後はサービスも再起動してください（hostel-server-setup、セクション「更新」）。

次のステップ

• ルームを使用する: hostel-use。
• 何か失敗した場合: hostel-troubleshoot。