x abox

abox 是一個用於管理 AI Agent Docker 容器的命令列工具。
它提供了快速啓動、停止、重啓容器的能力，以及通過 tmux、ssh、exec 等方式與容器交互的功能。
適用於本地開發和測試 AI 編程代理（如 Claude Code、Codex、OpenCode）的場景。

TIP

快速開始：

1. 啓動容器：x abox start
2. 連接到容器，並打開 tmux 名為 claude 的會話：x abox tmux :claude
3. 停止容器：x abox stop

例子

啓動默認容器（無 SSH）

x abox start

啓動容器並啓用 SSH（隨機密碼）

x abox start --pass - --port 2222

使用 SSH 公鑰啓動命名容器

x abox start --key ~/.ssh/id_rsa.pub --port 2222 -n mybox

刪除默認容器

x abox rm

列出所有 abox 容器

x abox ls

通過 tmux 連接到默認容器

x abox t

在容器中啓動名為 claude 的 tmux 會話

x abox tmux :claude

停止默認容器

x abox stop

暫停默認容器

x abox pause

恢復默認容器

x abox resume

在默認容器中啓動交互式 bash

x abox cmdi bash

清理所有 abox 容器和鏡像

x abox clearall

子命令

名称	描述
x abox start	啓動一個新的 abox 容器
x abox stop	停止指定的 abox 容器
x abox restart	重啓指定的 abox 容器
x abox pause	暫停指定的 abox 容器
x abox resume	恢復指定的 abox 容器
x abox rm	刪除指定的 abox 容器
x abox ls	列出所有 abox 容器
x abox fz	使用 FZF 交互式選擇 abox 容器
x abox clearall	停止並刪除所有 abox 容器和鏡像
x abox tmux	通過 tmux 連接到容器
x abox cmd	在容器中執行命令（非交互式）
x abox cmdi	在容器中執行命令（交互式）
x abox login	登錄到容器（啓動 bash）

x abox start

啓動一個新的 abox 容器

TIP

如果不指定容器名稱，默認使用 "abox-0"。

使用 --pass 或 --key 時必須指定 --port。

• 例子:

使用 SSH 公鑰啓動容器並映射端口

x abox start --key <ssh-pubkey-file> --port 2222

刪除默認容器

x abox rm

啓動默認容器（無 SSH）

x abox start

使用隨機密碼啓動容器，然後通過 SSH 連接（密碼見啓動輸出）

x abox start --pass - --port 2222 && ssh -p 2222 ai@localhost

使用 SSH 公鑰啓動名為 mybox 的容器，然後使用對應私鑰連接

x abox start --key ~/.ssh/id_rsa.pub --port 2223 -n mybox && ssh -p 2223 -i ~/.ssh/id_rsa ai@localhost

• 使用:

x abox start [OPTIONS]

• 选项:

名称, 名称简写	默认值	描述
--key		SSH 公鑰文件路徑（需要 --port）
--pass		SSH 密碼（需要 --port，使用 "-" 自動生成隨機密碼）
--port, -p		SSH 端口映射（主機端口）
--name, -n		容器名稱

x abox stop

停止指定的 abox 容器

TIP

如果不指定容器名稱，默認停止名為 "abox-0" 的容器。

• 例子:

停止默認容器 abox-0

x abox stop

停止名為 mybox 的容器

x abox stop mybox

• 使用:

x abox stop <#1>

• 参数:

参数	描述
#1	容器名稱（可選，默認為 abox-0）

x abox restart

重啓指定的 abox 容器

TIP

如果不指定容器名稱，默認重啓名為 "abox-0" 的容器。

• 例子:

重啓默認容器 abox-0

x abox restart

重啓名為 mybox 的容器

x abox restart mybox

• 使用:

x abox restart <#1>

• 参数:

参数	描述
#1	容器名稱（可選，默認為 abox-0）

x abox pause

暫停指定的 abox 容器

TIP

暫停容器會凍結其進程，但不停止容器。

如果不指定容器名稱，默認暫停名為 "abox-0" 的容器。

• 例子:

暫停默認容器

x abox pause

暫停名為 mybox 的容器

x abox pause mybox

• 使用:

x abox pause <#1>

• 参数:

参数	描述
#1	容器名稱（可選，默認為 abox-0）

x abox resume

恢復指定的 abox 容器

TIP

恢復被暫停的容器，繼續運行其進程。

如果不指定容器名稱，默認恢復名為 "abox-0" 的容器。

• 例子:

恢復默認容器

x abox resume

恢復名為 mybox 的容器

x abox resume mybox

• 使用:

x abox resume <#1>

• 参数:

参数	描述
#1	容器名稱（可選，默認為 abox-0）

x abox rm

刪除指定的 abox 容器

TIP

強制刪除容器，即使容器正在運行。

如果不指定容器名稱，默認刪除名為 "abox-0" 的容器。

• 例子:

刪除默認容器 abox-0

x abox rm

刪除名為 mybox 的容器

x abox rm mybox

• 使用:

x abox rm [OPTIONS] <#1>

• 参数:

参数	描述
#1	容器名稱

• 选项:

名称, 名称简写	默认值	描述
-n, --name		容器名稱

x abox ls

列出所有 abox 容器

TIP

列出所有名稱以 "abox-" 開頭的容器。

• 例子:

列出所有 abox 容器

x abox ls

• 使用:

x abox ls

x abox fz

使用 FZF 交互式選擇 abox 容器

TIP

啓動 FZF 界面，可以通過模糊搜索選擇容器進行操作。

• 例子:

啓動 FZF 交互式選擇容器

x abox fz

• 使用:

x abox fz

x abox tmux

通過 tmux 連接到容器

TIP

在容器中啓動一個 tmux 會話，適合長時間運行的交互式任務。

如果不指定容器名稱，默認連接名為 "abox-0" 的容器。

• 例子:

通過 tmux 連接到默認容器

x abox tmux

通過 tmux 連接到名為 mybox 的容器（簡寫）

x abox t mybox

通過 tmux 連接到名為 mybox 的容器中並啓動名為 claude 的 tmux 會話

x abox t mybox:claude

• 使用:

x abox tmux|t <#1>

• 参数:

参数	描述
#1	容器名稱（可選，默認為 abox-0）

x abox cmd

在容器中執行命令（非交互式）

TIP

在指定容器中執行命令，不分配 TTY。

如果不指定命令，默認執行 bash。

如果不指定容器名稱，默認使用名為 "abox-0" 的容器。

• 例子:

在 mybox 容器中執行 ls -la

x abox cmd -n mybox ls -la

在默認容器中以 root 執行 apt update

x abox cmd -r apt update

• 使用:

x abox cmd [OPTIONS] [FLAGS] <#1>

• 参数:

参数	描述
#1	要執行的命令

• 选项:

名称, 名称简写	默认值	描述
-n, --name		容器名稱

• 指令:

名称, 名称简写	描述
-r, --root	以 root 用户執行命令

x abox cmdi

在容器中執行命令（交互式）

TIP

在指定容器中交互式執行命令，分配 TTY。

如果不指定命令，默認執行 bash。

如果不指定容器名稱，默認使用名為 "abox-0" 的容器。

• 例子:

在 mybox 容器中啓動交互式 bash

x abox cmdi -n mybox bash

在默認容器中以 root 啓動交互式 bash

x abox cmdi -r bash

• 使用:

x abox cmdi [OPTIONS] [FLAGS] <#1>

• 参数:

参数	描述
#1	要執行的命令

• 选项:

名称, 名称简写	默认值	描述
-n, --name		容器名稱

• 指令:

名称, 名称简写	描述
-r, --root	以 root 用户執行命令

x abox login

登錄到容器（啓動 bash）

TIP

在容器中啓動一個 bash shell，用於直接操作容器。

如果不指定容器名稱，默認登錄名為 "abox-0" 的容器。

• 例子:

登錄到默認容器

x abox login

登錄到名為 mybox 的容器

x abox login mybox

• 使用:

x abox login <#1>

• 参数:

参数	描述
#1	容器名稱（可選，默認為 abox-0）

x abox clearall

停止並刪除所有 abox 容器和鏡像

TIP

此命令會：

1. 停止所有名稱以 "abox-" 開頭的容器
2. 刪除所有名稱以 "abox-" 開頭的容器
3. 刪除 abox 鏡像

注意：此操作不可逆，請謹慎使用。

• 例子:

清理所有 abox 容器和鏡像

x abox clearall

• 使用:

x abox clearall

TIP

在交互式终端中（如 zsh, bash ...），可以使用 Tab 获取补全信息

运行 CMD SUBCOMMAND --help 可以获取命令的更多信息