mcpField
A
agentbox

agentbox

github.com/madarcoエージェントワークフロー560203 回インストール5 週間前に更新
リポジトリ

agentbox について

現在の Claude Code セッションを新しい AgentBox 環境に分岐させるスキルです。プロバイダーを選択でき、進行中のプランも新しいボックスに引き継げます。

主な機能

  1. 01現在の Claude Code セッションを分岐
  2. 02対応プロバイダーから選択
  3. 03進行中のプランをボックスに引き継ぎ
  4. 04Hetzner ボックス用の SSH 接続を準備

活用シーン

  1. 01別のボックスでセッションを続行
  2. 02新しいボックスでプランを再開
  3. 03Hetzner ボックスへの SSH 接続を設定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/madarco/agentbox --skill agentbox

インストール後、Claude Code で/agentboxを入力して読み込まれたか確認します。

詳細

現在の Claude Code セッションを、新しい AgentBox ボックスにフォークします。

  1. $ARGUMENTS からプロバイダーフラグを解決します。

    • 空 → フラグなし（デフォルトの docker プロバイダーを使用）
    • docker | daytona | hetzner | vercel | e2b → --provider $ARGUMENTS を渡します
    • その他 → 停止し、有効な値が docker、daytona、hetzner、vercel、e2b であることをユーザーに伝えます

  2. アクティブなプランを検出します（--plan は任意）。 このセッションで直前に Claude Code のプランに取り組んでいた場合、ボックスに引き継ぎ、フォーク後もプランモードで再開できるようにします。

    • このセッションのプランファイルのパスがわかっている場合（プランモードでは ~/.claude/plans/<slug>.md に書き込まれ、この会話で直前に作成したプランからパスがわかります）、そのパスを使用します。

    • それ以外の場合は、直近 15 分以内に更新されたものに限り、最も新しいプランを探します（別のタスクの古いプランを復活させないでください）。Bash ツールで次を実行します。

      find "$HOME/.claude/plans" -name '*.md' -mmin -15 -type f 2>/dev/null \
  | xargs -r ls -t 2>/dev/null | head -1

      パスが出力された場合は、それが現在のプランです。何も出力されなければ、アクティブなプランはないため、--plan は省略します。

  3. フォークします。 プランモードの場合は終了してから、Bash ツールで次のコマンドをちょうど 1 つ実行します（手順 2 でプランが見つかった場合に限り、--plan "<path>" を追加します）。--session は渡さないでください。agentbox fork は現在の Claude セッションを自動検出します（安全のため、このワークスペースで最も新しいセッションにフォールバックします）。これは、このスキルがサブエージェント内で実行され、$CLAUDE_CODE_SESSION_ID がフォーク対象の会話ではなくサブエージェントの ID になっている場合にも正しく動作します。

    agentbox fork [--provider $ARGUMENTS] [--plan "<plan path>"]

  4. 結果を伝えます。 1 行で、新しいボックス名（コマンド出力から取得）を伝え、ホストセッションには影響がないことを確認します。--plan を渡した場合は、ボックスがプランモードで開き、すぐに再開できることも伝えます。会話の要約はしないでください。フォークにはすでに会話が含まれています。

Hetzner クラウドボックスの場合に限り、Codex App または Claude Desktop では、ユーザーがボックスへの SSH 接続を追加できます。そのためには、まず SSH 設定にエイリアスを追加し、その後、接続の追加方法を案内します。

agentbox shell <box> --ssh-config          # writes ~/.ssh/config + prints details

ユーザーがボックスへの接続に使用できる SSH エイリアスを追加するには

Codex App を使用している場合は、簡単に接続できるよう、回答にクリック可能なリンクを返します。

[Add <ssh-alias> to Codex SSH](codex://settings/connections/ssh/add?name=<ssh-alias>)

トラブルシューティング

  • agentbox コマンドが失敗した場合は、チャットで ! npm -g install @madarco/agentbox を実行して AgentBox をインストールするようユーザーに伝えてください。
  • 環境に AGENTBOX_RELAY_URL が設定されている場合は、ボックス内で実行されています。このコマンドは v1 ではホスト上でのみ使用できます。ボックスから別のボックスへのフォークはまだサポートされていないことをユーザーに伝えてください。
  • Agentbox について詳しく知る必要がある場合は、完全なドキュメントが含まれている /agentbox-info スキルを確認してください。

コメント

Markdown 対応