using-exe-dev

概要

exe.dev は、永続ディスク、即時 HTTPS、組み込み認証を備えた Linux VM を提供します。管理はすべて SSH 経由で行います。

ドキュメント

• ドキュメントのインデックス：https://exe.dev/docs.md
• すべてのドキュメントを1ページにまとめたもの（大容量です！）：https://exe.dev/docs/all.md

インデックスは段階的に情報をたどれるように構成されています。まずインデックスを開き、必要に応じてリンクをたどってください。

クイックリファレンス

ssh exe.dev help             # show commands
ssh exe.dev help <command>   # show command details
ssh exe.dev new --json       # create VM
ssh exe.dev ls --json        # list VMs
ssh exe.dev rm <vm>          # delete VM
ssh <vm>.exe.xyz             # connect to VM
scp file.txt <vm>.exe.xyz:~/ # transfer file

すべての VM で、自動 TLS を備えた https://<vm>.exe.xyz/ が利用できます。

初回登録

次の出力は、処理の停止やバグではありません。

• {"error":"Registration is required.","action":{"type":"command","command":"ssh -t ..."}}（終了コード 1）：SSH キーにアカウントが紐付いていません。ユーザーのメールアドレスを確認し、同意を得てから、PTY で action.command を実行してください。
• {"error":"Choose a plan to start creating VMs. ..., "action":{"type":"command","command":"ssh ... billing activate --json"}}：アカウントにプランがありません。action.command を実行し、「復旧」を参照してください。

ルール

• ssh exe.dev を実行する前に、ユーザーにメールアドレスを尋ね、exe.dev アカウントを作成する意思があることを確認してください。メールアドレスを推測してはいけません。メールアドレスの入力欄に事前入力されている場合は、ユーザーに確認するか、Ctrl-U で消去してください。
• ユーザーのメールボックスを読んだり、カード情報を入力したり、ChatGPT へのサインインを行ったりしてはいけません。確認、承認、支払いはユーザーが行います。
• リンクを開くとブラウザーにログインします。サブスクリプションへの同意を意味するものではありません。
• リンクはベアラー認証情報です。ユーザーへの返信にのみ記載し、ファイル、ログ、コミット、イシューには記載しないでください。リンクが漏洩した場合は、使用しないようユーザーに伝えてください。

PTY で実行してください。 標準入力が閉じられているか EOF になると、登録はキャンセルされます。各待機時間は最長 10 分で、Ctrl-C で終了します。デタッチして起動し、15～30 秒ごとに短いコマンドでポーリングしてください（または expect や Python の pty を使用してください）。

tmux new-session -d -s exe-signup -x 120 -y 40 'ssh exe.dev'
tmux capture-pane -p -J -t exe-signup
tmux send-keys -t exe-signup '<email>' Enter

ユーザーに伝えること

• Verification email sent to:：exe.dev から届いたメール内のリンクをクリックしてください。
• Click here to verify: または Verify with <provider>:：その URL を開いてください。
• Choose a plan to start creating VMs:：Personal（1人）、Work（チーム）、Later のいずれかを尋ねてください。personal、work、later のいずれかを入力します。
• Open this link to activate：URL を渡してください。一度だけ使用でき、有効期限は15分です。Personal では、有料 ChatGPT サブスクリプション（カード不要）または Stripe サブスクリプションを連携すると、7日間の無料トライアルを利用できます。Work は Stripe のチームサブスクリプションです。
• ウェルカム時のヒントに表示される Connect a paid ChatGPT subscription or subscribe with Stripe:：Personal 用のリンクです。同じ方法でユーザーに渡してください。

結果

• ✓ Personal plan active.、✓ Work plan active.、✓ ChatGPT connected.：準備完了です。ChatGPT のトライアルは、最初の VM を作成したときに開始されます。
• Skipped.、Skipped in the browser.、Timed out waiting for activation.、Could not create an activation link.、または later：new は引き続き失敗します。「復旧」を参照してください。

続行してください。 exit を送信し、tmux セッションが残っている場合は終了してから、元の ssh exe.dev new --json を再実行してください。

復旧

• プランがない、またはリンクの有効期限が切れた場合：エラーに表示された action.command を実行してください。billing activate --json は、ウェルカム時のヒントに表示されたものと同じ Personal 用リンクを {"url":...} の形式で返します。同じ方法でユーザーに渡し、ユーザーの確認後に ssh exe.dev new --json を再実行してください。{"error":...}（終了コード 1）が返された場合、このアカウントでは有効化できません。その場合、ssh exe.dev billing manage --json を実行すると、Stripe 専用の {"url":...} が返されます。
• Verification still pending. または Email verification timed out.：メールのリンクは送信から15分間有効です。ユーザーがリンクをクリックしたら、ssh exe.dev new --json を再実行してください。有効期限が切れた場合、またはメールが届かなかった場合は、PTY セッションを再実行してください。
• 待機中にあなたの作業時間が終わる場合：リンクの有効期限が15分であること、完了したら知らせてほしいことをユーザーに伝えてください。その後、ssh exe.dev new --json を再実行してください。
• PTY ツールがない場合：ユーザーの同意を得た後、printf '%s\n' "$EMAIL" | ssh exe.dev を実行すると、メールアドレスが送信され、Verification still pending. で終了します。プランの入力を省略するため、プランがないというエラーが表示されます。

2 つの SSH 接続先について

• ssh exe.dev <command> — exe.dev のロビーです。VM のライフサイクル、共有、設定を操作する REPL です。scp、sftp、任意のシェルコマンドには対応していません。
• ssh <vm>.exe.xyz — VM への直接接続です。シェル、scp、sftp、ポートフォワーディングなど、SSH のすべての機能を利用できます。

非インタラクティブ環境およびサンドボックス環境での作業

コーディングエージェントは、非インタラクティブシェルやサンドボックス内で SSH を実行することがよくあります。よくある問題と回避策は次のとおりです。

scp／sftp の失敗：接続先が exe.dev ではなく <vm>.exe.xyz であることを確認してください。SSH を使った回避策を利用してください。

接続のハング：非インタラクティブな SSH は、出力が表示されないままホスト鍵の確認プロンプトでブロックされることがあります。新しい VM への初回接続では、-o StrictHostKeyChecking=accept-new を使用してください。

SSH 認証：ユーザーが既に使用している SSH エージェントまたはホスト設定を利用してください。認証に失敗した場合は、exe.dev と *.exe.xyz の両方に適切な ID を設定するようユーザーに依頼してください。秘密鍵を調べたり、コピーしたり、送信したりしないでください。