connect

ホストコマンド： Cursor のデスクトップアプリと Cursor のターミナルでは、/begin、/connect、/status、/next-lesson として同じ共有スキルを呼び出します（名前が重複する場合は、スキルピッカーで Altitude を選択します）。このファイル内の /altitude:<skill> の例は、Cursor では /<skill> に置き換えてください。Claude Code では /altitude:<skill> を、Codex では $<skill> をそのまま使用します。

Copilot ホストコマンド： GitHub Copilot CLI と VS Code Copilot チャットでは、同じ共有 Altitude スキルを使用します。ホストのスキルピッカーで名前（connect、begin、next-lesson、または status）から Altitude スキルを選択し、ホストに表示される呼び出し形式を使用します。これらのファイルを Copilot 専用の別のスキルライブラリにコピーしないでください。Altitude プラグイン一式にはレッスンフックが含まれていますが、コピーしたスキルだけでは単独で利用できる無料の方法のみが提供されます。

現在のコーディングエージェントのインストールを Altitude に接続します。

Cursor の準備（すでにペアリング済みのインストールを含む）： プラグインのセットアップまたはペアリングの前に、学習者自身のターミナルで altitude update を実行し、完了するまで待ってください。altitude が見つからない場合は、代わりに npm install -g @learnaltitude/cli を使用してください。その後、ペアリングを実行する環境と同じ環境から altitude --version を確認します。古い CLI は --agent cursor を認識しません。プラグインを更新するだけでは、そのエージェント識別子は追加されません。CLI を更新しても Cursor が拒否される場合は、既存のペアリング／バインディング／進捗を維持し、この CLI はまだ Cursor に対応していないことを報告してください。--agent を指定せずに、または別のエージェントの識別子を指定して、ペアリングを再実行してはいけません。更新が成功しても、レッスンが合格基準を満たした証明にはなりません。

1. 実行中のエージェントを特定し、そのバージョンを取得します。

   • Claude Code： claude --version を実行し、先頭のセマンティックバージョン番号を取得します。
   • Codex： codex --version を実行し、出力される codex-cli x.y.z からバージョンを取得します。 0.131.0 より古い場合は、Altitude のセッションフックには Codex CLI >= 0.131.0 が必要であることをユーザーに伝え、まず更新するよう提案します。ペアリング時の最終判断はサーバーが行います。
   • GitHub Copilot CLI： copilot --version を実行し、表示された CLI バージョンを使用します。
   • VS Code Copilot チャット： VS Code の拡張機能から、インストール済みの GitHub Copilot Chat 拡張機能のバージョンを確認します。code --version で取得したエディターのバージョンとは分けて管理し、Copilot のバージョンとして代用しないでください。
   • Cursor デスクトップ： cursor --version（1 行目）または Cursor の「バージョン情報」からデスクトップのバージョンを確認します。ターミナルエージェントのバージョンで代用しないでください。
   • Cursor ターミナル： cursor-agent --version（またはインストールされているコマンドが agent の場合は agent --version）を実行します。日付とビルド番号を含むバージョン文字列をそのまま保持し、セマンティックバージョンを作り出さないでください。
   • Cursor 互換性セットアップ： この呼び出しに付随するソースパス、または実際に読み取ったファイルを使って、インストール済みの skills/connect/SKILL.md を基準に ../../bin/altitude-cursor-setup.mjs のパスを解決します。シェルにプラグインフックの環境変数が存在すると想定しないでください。ソースパスを利用できない場合は、Cursor のプラグインマネージャーから現在有効なインストール場所を特定します。最新のキャッシュディレクトリや別のチェックアウトを選ばないでください。その後、node '<that actual absolute file path>' install を実行します（現在のシェルに合わせて引用符で囲みます）。この処理では、現在のプラグインのルートを JSON データとして ~/.cursor/altitude/plugin.json に記録します。Cursor から別のプラグインのルート環境変数が渡される場合があるため、ネイティブフックはこの登録情報を読み取ります。プラグインを更新するたびに /connect を再実行し、新しく有効になったスキルソースから登録情報を更新します。登録情報がない、または古い場合はフェイルオープンし、/connect の診断メッセージが表示されます。このセットアップでは、ターミナルエージェントがネイティブプラグインのターンフックを呼び出せるよう、所有する不活性なユーザーフックの項目を 3 つ冪等に追加します。既存のフックは保持されます。配布されたスクリプトを実行してください。設定を手作業で再作成しないでください。セットアップに失敗した場合は、短いエラーメッセージを伝え、設定はそのままにしてください。スクリプトのないコピー済みスキルは完全なプラグインではありません。Cursor のプラグインマネージャーを使って完全なプラグインをインストールしてください。セットアップに変更を加えた後、レッスンを始める前に新しい Cursor セッションを開始してください。削除するには、同じインストール済みスクリプトに uninstall を指定します。Altitude の互換性項目と、それに一致する登録情報のみが削除されます。古いプラグインが新しい登録情報を消去することはありません。 Cursor のペアリング判断： 互換性セットアップの後、新しいデバイスフローを開始する前に altitude status を実行します。このコマンドはローカルでキャッシュのみを確認します。connected は、読み取り可能で形式が正しい保存済みトークンが存在するかどうかを示します。アカウントを特定したり、サーバーがそのトークンを受け入れるか確認したりするものではありません。意図したアカウントであることや、オンライン認証が正常であることの証拠として扱わないでください。
   • connected: true の通常の初期設定やプラグイン更新時のメンテナンスでは、既存のペアリングを保持し、手順 2～4 をスキップします。既存のローカルペアリングが保持され、プラグインの登録が完了したことを伝え、以下のステータスの概要とインストール確認に進みます。設定を変更した場合は、/begin または /next-lesson を実行する前に、新しい Cursor セッションが必要です。
   • 学習者が明示的に再接続またはアカウントの変更を求めた場合は、ローカルトークンが存在していてもペアリングを続行します。新しい CLI リクエストがすでに unauthorized を返している場合は、サーバーが保存済みの認証情報を拒否したことを説明し、修復のためにペアリングを続行します。認証情報を開示したり、バインド、プラン、キューに入った進行状況を削除したりしないでください。
   • connected: false の場合、保存済みトークンが存在しないか、形式が不正です。ペアリングを続行します。オフラインまたはネットワークによって読み込みがブロックされている場合、キャッシュされたジャーニーデータがない場合、フラッシャーがアイドル状態の場合は、トークンが無効であることを意味しません。また、自動的な再ペアリングを開始することもありません。
   • ステータスコマンドが失敗した場合、またはその出力を読み取れない場合は、簡潔な診断結果を伝え、ここでペアリングの判断を止めます。ステータスの失敗だけを理由に接続が切れていると推測したり、ペアリングを開始したりしないでください。既存のローカル状態と、更新した登録を保持します。

2. エージェント用のペアリングコマンドをバックグラウンドで開始します。

   • Claude Code： altitude connect --agent claude-code --agent-version <version> --next-hint "Open your coding agent in your project folder and run /altitude:begin to start your journey."
   • Codex： altitude connect --agent codex --agent-version <version> --next-hint "Open your coding agent in your project folder and run $begin to start your journey."
   • GitHub Copilot CLI または VS Code Copilot chat： altitude connect --agent copilot --agent-version <observed Copilot version> --next-hint "Open your project in Copilot and choose Altitude begin to start your journey."
   • Cursor デスクトップまたはターミナル： altitude connect --agent cursor --agent-version <observed version> --next-hint "Open your coding agent in your project folder and run /begin to start your journey."

   Codex の補足 — サンドボックス： Codex のデフォルトモードでは、シェルからインターネットにアクセスできないため、単純に altitude connect をバックグラウンドで実行すると、コードを出力する前に失敗します。このコマンドだけに権限昇格を求め、理由を 1 行で説明します（「Altitude では、このコンピューターをアカウントとペアリングするためにネットワークアクセスが必要です」）。拒否された場合、またはホストにそのような仕組みがない場合は、むやみに再試行せず、インストールの問題だと判断しないでください。学習者に、上記の正確な altitude connect の行を自分のターミナルで実行するよう伝え、出力された URL とコードを貼り付けてもらい、それらを使って手順 3 から続行します。

3. 出力された確認用 URL とワンタイムコードを、すぐにユーザーに伝えます。

4. ユーザーがブラウザーで確認するまで待ち、コマンドが正常に完了したかどうかを報告します。学習者が自分のターミナルでコマンドを実行した場合は、成功が報告されたら知らせてもらうよう依頼します。

5. altitude status を実行し、接続、バインド、ジャーニーの状態を要約します。

6. Codex の補足 — 初回の信頼確認： Codex は、Altitude をインストールした状態で初めて起動するときに「Hooks need review」と表示します。また、プラグインの更新によってフックが変更された後にも再度表示します。表示されたら、その都度、学習者に Trust all and continue を選ぶよう伝えます。以前に閉じてしまった場合は、今すぐ /hooks を開き、Altitude のフックを信頼するよう依頼します。これらのフックはサンドボックスの外部で実行され、ジャーニーのローカルコピーを最新の状態に保ちます。そのため、サンドボックス内から $begin と $next-lesson でジャーニーを読み取れます。信頼しない場合は、レッスンを始めるたびに、自分のターミナルでコマンドを実行するよう求められます。

7. Cursor のインストール確認： フックを含む Altitude ネイティブプラグイン全体が読み込まれている必要があります。コピーした skills/ フォルダーは、単独で利用できる無料の方法にのみ使用します。Cursor の Customize と Hooks の出力を使って読み込みを確認し、新しい会話を開始してください。既存のユーザーフックとプロジェクトフックは保持してください。この統合では、デスクトップとターミナルのレッスンが完全に受け入れられるのを待っている段階です。ペアリングに成功したことを、レッスンが機能する証明として主張したり、サーバーの互換性に関する一時停止を回避したりしないでください。

Copilot のインストール確認： Altitude ネイティブプラグイン全体をインストールし、このプロジェクトのフックを信頼して、意図したプロジェクトフォルダーで Copilot の会話を開き直してください。プラグインは、共有スキルとライフサイクルフックの両方を公開する必要があります。VS Code では、テスト済みの統合に Local エージェントを使用してください。他のエディターのエージェントホストについては、個別に検証する必要があります。ペアリングする前に altitude --version を実行し、Copilot support で CLI とサーバーの要件を確認してください。--agent copilot が拒否された場合は、既存のペアリングと進行状況を保持し、不足している CLI サポートを報告してください。互換性を回避するために --agent を省略したり、別のエージェントとしてペアリングしたりしないでください。新規インストールで無条件に更新する必要はありません。ドキュメントに記載されているリリース互換バージョンを使用してください。

デバイスフローを変更したり、altitude CLI 以外を通じて認証情報を送信したりしないでください。