閉じた VS Code の窓を、コンテナを再起動せずに開き直す。devbase up の最後の段（[6/6]）で開くのと
同じ窓（dev コンテナへ接続したフォルダ、リポジトリが 2 件以上ならワークスペース）を開く。
| 入口 | 形 |
|---|---|
| トップレベル | devbase open [name] [--open-index N] [--context NAME] |
project グループ |
devbase project open [name] [--open-index N] [--context NAME] |
container / ct グループ（非推奨） |
devbase container open [--open-index N] [--context NAME] |
devbase list の TUI |
起動中のプロジェクトの操作メニューの先頭「エディタを開く (open)」。dev コンテナが 2 つ以上動いていれば、開くものを選ぶ |
dev コンテナが 1 つ以上動いていれば、コンテナ・ボリューム・ネットワークに触らずに窓を開く。1 つも
動いていなければ devbase up --open と同じく起動してから開く。devbase up の --open /
--no-open / --open-index と自動オープンの仕組みはそのまま残り、open はそれを置き換えない。
| 用語 | 意味 |
|---|---|
| 窓 | dev コンテナへ Dev Containers 拡張で接続した VS Code のウィンドウ |
| 動いているインスタンス | docker ps（-a なし）に現れ、Compose のプロジェクトのラベルが対象のプロジェクトで、サービスのラベルが <開発サービス名>-<1 以上の数字> のコンテナ |
| 番号（index） | 開くインスタンスの番号（dev-1 の 1）。--open-index N、無ければ環境変数 DEVBASE_OPEN_INDEX、それも無ければ 1 |
| 開発サービス名 | get_dev_service_name() が返す名前（DEV_SERVICE_NAME。未設定か空なら dev） |
| 要素 | 置き場所 | 責務 |
|---|---|---|
| 引数の受け口 | lib/devbase/cli.py |
_add_open_subparser(sub, *, with_name)。--open-index と --context は常に、[name] は project とトップレベルだけ登録する。allow_abbrev=False。SHORTCUTS / SUBCMD_MAP / epilog / _expand_argv の候補 |
| 入口のシェル | bin/devbase |
resolve_command の候補、Python 実装のコマンドの case、名前解決の _PROJECT_NAME_SUBCOMMANDS / _NAME_RESOLVABLE_SHORTCUTS |
| 振り分け | lib/devbase/commands/container.py |
_dispatch_lifecycle の handlers の open |
| 本体 | lib/devbase/commands/container.py |
cmd_open。番号の解決は _explicit_open_index（環境変数の読み方は up と共有する _open_index_from_env） |
| 開く処理 | lib/devbase/commands/container.py |
_open_editor_at。開く対象（フォルダかワークスペースか）と compose file と接続先を組み、opener.open_editor の結果を返す。有効判定と番号の解決は持たない。up の _maybe_open_editor も同じ関数を通る |
| 起動中の判定 | lib/devbase/utils/docker.py |
running_dev_instances(project, dev_service_name, runner=None)。devbase env token の配り先（env.py の _running_dev_containers）と共有する |
| 一覧の操作メニュー | lib/devbase/tui/actions_project.py |
_RUNNING_OPS の先頭と _OP_HANDLERS["open"]（_op_open）。開く先の候補は container.project_open_candidates が返す |
| シェル補完 | etc/devbase-completion.bash、etc/_devbase |
トップレベル・project・container の open、[name] と --open-index / --context |
型（クラス）は追加していない。モジュール関数の並びで構成する。
graph TD
W[bin/devbase] --> P[cli.py]
P --> D[_dispatch_lifecycle]
T[TUI actions_project] --> D
D --> O[cmd_open]
O --> R[running_dev_instances]
O -->|起動中| E[_open_editor_at]
O -->|停止中| U[cmd_up]
U --> M[_maybe_open_editor]
M --> E
E --> V[opener.open_editor]
open の起動中の経路が docker daemon に対して行うのは、読み取りの docker ps と、opener.open_editor
が実コンテナ名を問い合わせる docker compose ps だけである。
graph TD
A[番号を解決<br/>CLI → DEVBASE_OPEN_INDEX → 1] --> B{0 以下か}
B -->|はい| X1[終了コード 1]
B -->|いいえ| C[context を反映し<br/>機密を注入]
C --> Q[docker ps で<br/>動いている番号を得る]
Q -->|失敗| X2[終了コード 1<br/>up へは進まない]
Q -->|0 個| U[cmd_up<br/>open_editor=True]
U --> X3[cmd_up の戻り値]
Q -->|1 個以上| K{番号が<br/>含まれるか}
K -->|いいえ| X4[終了コード 1<br/>起動中の番号を示す]
K -->|はい| E[_open_editor_at]
E -->|skip| X5[終了コード 1]
E -->|launch / print_command| X6[終了コード 0]
- 起動中かどうかは「動いているインスタンスが 1 つ以上あるか」で決め、番号の検査と分ける。 番号の
コンテナ名が解決できないことを停止中と読むと、scale 1 で動いているプロジェクトへ
--open-index 2を 渡しただけでupが環境を作り直す。opener.resolve_container_nameは問い合わせに失敗すると決定的な 名前へ落ちるため、判定には使わない - 状態を取得できないときは
upへ進まずに止まる。docker psの失敗は停止中を意味しないためである - 停止中は
cmd_up(open_editor=True, open_index=<利用者の値>)へ委譲し、自前で開き直さない。 起動直後に 開く compose file はupの側で決まる。番号の範囲外はupの既存の扱い（警告して 1）に従う DEVBASE_OPEN_EDITORとproject.ymlのopen_editorは見ない。明示のコマンドは開く意思表示そのもので あり、upの自動オープンの可否とは別に扱う- 番号の上限は
project.ymlのscaleではなく動いているインスタンスで決まる（devbase scaleで増やした 分も開ける） - 接続先は
upと同じ優先順位（--context>DEVBASE_DOCKER_CONTEXT>project.local.yml）で決め、docker psの環境変数DOCKER_CONTEXTと、opener.open_editorのdocker_contextの両方に使う - 機密は
loginと同じく任意で注入する（openerのdocker compose psの補間のため）
| 状況 | 終了コード | 出力 |
|---|---|---|
開いた（launch）・SSH で手元のコマンドを提示した（print_command） |
0 | エディタを開きます: <dev>-<N> と opener の出力 |
| 停止中 | cmd_up の戻り値 |
dev コンテナが起動していないため up を実行します (起動後にエディタを開きます) |
開けなかった（skip: 非 TTY・code が無い） |
1 | opener が出す理由 |
| 番号が 0 以下 | 1 | open index N は 1 以上を指定してください（docker を呼ばない） |
| 番号が動いていない | 1 | <dev>-<N> は起動していません。起動中: 1, 2 |
docker ps が失敗した |
1 | docker ps の失敗の理由と dev コンテナの状態を取得できないため、エディタを開けません |
--open / --no-open、およびその値付きの形（--open 2 / --open=2） |
2 | argparse の usage エラー。サブパーサーの allow_abbrev=False により、--open-index の前方一致として受け付けない |
name が解決できない |
1 | 既存の _enter_project の候補提示 |
container open は [name] を取らない（container の他のサブコマンドと同じ）。bin/devbase の name 解決も
container / ct を通さないため、devbase container open <name> は実在する名前でも usage エラー（終了コード 2）に
なる（PLAN61 決定 10）。前方一致では devbase o が open に、devbase project o / container o も open に解決する。devbase l → login、devbase project p
→ ps は変わらない。
docker ps --filter label=com.docker.compose.project=<project> --format '{{.Names}}\t{{.Label "com.docker.compose.service"}}'を 1 回呼ぶ- プロジェクトのラベルで絞り、サービス名が
^<開発サービス名>-([1-9][0-9]*)$に合う行から(番号, コンテナ名)を 集め、番号の昇順で返す。同じプロジェクトの DB などと、区切りやコンテナ名を欠く行は除く - 呼び出しの例外・0 以外の終了コードは error ログを出して
Noneを返し、0 個の[]と区別する - Compose のファイルを読まないため、
.docker-compose.scale.ymlの有無と構成の補間に左右されない
| 項目 | 内容 |
|---|---|
| 位置 | 起動中の行の操作メニューの先頭（Enter 1 回で決まる位置）。以下は再起動 (up)・停止 (down)・ログイン (login) … の順 |
| 開く先の選択 | container.project_open_candidates(<name>) が、対象プロジェクトへ切り替えて cmd_open と同じ接続先へ running_dev_instances を問い合わせ、動いているインスタンスと既定の番号（切り替え先の DEVBASE_OPEN_INDEX、無ければ 1）を返す。動いているものが 2 つ以上なら、コンテナ名を並べた選択を出す。カーソルの初期位置は既定の番号で、それが動いていなければ動いているものの先頭。Esc でサブメニューへ戻り、Ctrl-C で全体を中止する（どちらも開かない） |
| 委譲 | 選んだときは dispatch_lifecycle("open", <name>, open_index=<選んだ番号>)。動いているものが 1 つ以下か、候補を得られない（名前を解決できない・docker ps が失敗した）ときは選ばせず open_index=None で委譲し、停止中の起動とエラーの出し方は cmd_open に任せる |
| 実行後 | コンテナの数が変わらないため、トップの一覧へ戻らずサブメニューに留まる（_BACK_TO_TOP_OPS に含めない）。成否によらず続けて別の操作を選べる |
停止中の行は従来どおり選ぶと直接 up する。
| 設定 | 扱い |
|---|---|
DEVBASE_OPEN_INDEX |
--open-index を省いたときの番号。数でなければ 1。up と読み方を共有する |
DEVBASE_OPEN_EDITOR / project.yml の open_editor |
open では見ない |
DEVBASE_EDITOR / DEVBASE_EDITOR_SSH_HOST / DEVBASE_EDITOR_DOCKER_CONTEXT / DEVBASE_WORKSPACE |
opener.open_editor が従来どおり読む |
永続データは持たない。
- 窓を閉じた後はコンテナを止めずに
devbase openで開き直す - 非 TTY（CI・パイプ）では
openerが開くのを見送り、終了コード 1 になる
自動テストは running_dev_instances・opener.open_editor・cmd_up を差し替え、up のパイプラインの部品は
呼ばれたら落ちるスタブにする。実 docker と実 DEVBASE_ROOT には触れない。
- 起動中の経路で
opener.open_editorが 1 回だけ呼ばれ、compose up / down・ボリューム / ネットワークの作成・ pre-up チェック・自動スナップショット・deployフック・cmd_upが呼ばれないこと。自動オープンの無効化 （環境変数・project.yml）が効かないこと。project.ymlのscaleを超える番号も動いていれば開けること、 環境変数の番号・空・数でない値・飛び番号の扱い。動いていない番号・0 以下・docker psの失敗でcmd_upを 呼ばずに 1 になること。--contextが状態の照会とエディタの両方に届くこと。skipで 1、print_commandで 0。 停止中にcmd_upへopen_editor=Trueと利用者の番号が渡ること。upの自動オープンの範囲外の扱いと有効判定が 変わらないこと（tests/commands/test_container_open.py） running_dev_instancesの並び・プロジェクトのラベルでの絞り込み・-aを付けないこと・dev 以外と不完全な 行を除くこと・サービス名のドットを文字どおり扱い先頭ゼロを除くこと・失敗でNone（tests/utils/test_running_dev_instances.py）。env tokenの既存テストが変わらず通ること （tests/commands/test_env_token.py）- 3 入口の parse、
container openが名前を拒むこと、--open/--no-openと値付きの前方一致の拒否、 ショートカットとproject openが名前を解決してからcmd_openへ渡すこと、前方一致、bin/devbaseが名前を 取り除いて移動すること（tests/cli/test_open_command.py） - TUI の先頭・委譲の属性・サブメニューに留まること・成否によらず次の操作を選べること。動いているものが 2 つ以上で
選ばせ、選んだ番号で委譲すること、1 つ以下と候補が無いときは選ばせないこと、カーソルの初期位置、Esc と Ctrl-C で
開かないこと（
tests/cli/tui/test_open_menu.py、tests/cli/tui/test_actions_project.py）。selectの初期位置の受け渡し （tests/cli/tui/test_menu.py） project_open_candidatesの返す値・切り替え先の接続先へ問い合わせること・名前を解決できない／docker psの失敗でNone（tests/commands/test_container_open.py）- bash / zsh の補完（
tests/cli/test_completion.py）
実機（起動中のプロジェクト、非 TTY）では、open / open --open-index <動いていない番号> /
open --context <存在しない context> / open --open 2 / project open --open-index 2 の終了コードが上の表の
とおりで、前後で dev コンテナの ID と StartedAt が変わらないことを確かめる。TTY の端末から窓が開くこと、
devbase list の先頭が open であることは配布後の確認の対象である。
- CLI リファレンス:
devbase project open - 環境変数ガイド: エディタ自動オープン
- 別ホストの Docker への dev コンテナ起動（docker context）
- 位置引数の解決（プロジェクト名・イメージ名）
- 課題: #197。設計 PR: #198、実装 PR: #199