guide / tui· 2026-08-15

The board is the product.

dc-tui              # this folder (cwd, then git root)
dc-tui ~/src/app
dc-tui --all        # every labeled workspace

Startup draws the dc-cli mark (host frame + amber pip). Any key skips. DC_TUI_NO_SPLASH=1 skips it. The compact mark stays in the header.

dc-tui board

Primary row: start · shell · stop. Meta is quieter. rm asks y/n. Stack / fleet: up / down, j/k or click, Enter to open or exec.

Keys

Button Key Does
start u dc-up + dc-forward (needs .devcontainer)
shell e dc-exec — app only
stop s full stack dc-down
rm x dc-down --rm after y
open o host editor on the bind-mount
attach a VS Code Remote URI; Zed prints Connect Dev Container steps
ports p dc-forward (Colima sidecar)
logs l docker logs -f on the app
fleet f other workspaces
more / quit ? / q legend / exit
disk d dc-df report (stays in TUI)
rows j/k, Enter cursor; fleet opens a folder, stack execs

Header shows a compact disk line from dc-df. Reclaim stays CLI-only (dc-prune --yes).

App vs other services

Target Command How
labeled app dc-exec / key e devcontainer exec
any other compose service click the stack row, or dc-exec --service NAME start if down, then exec

There is no dc meta-binary.

See also ports and the README TUI.

FAQ

What is the difference between open and attach?
Open is the host editor on the bind-mount (Zed, VS Code, Sublime). a / dc-open --attach is the VS Code Remote URI into Linux. Zed attaches itself. Sublime cannot.
How do I work inside the container in Zed?
dc-up then dc-open. In Zed use Project: Open Remote → Connect Dev Container. dc-cli owns ports, stop, and fleet. Zed does not publish forwardPorts. No extension.
Does e / shell enter a compose sidecar?
No. e and shell are always the labeled app. Click a stack row, or dc-exec --service NAME, for siblings.
Why does the TUI come back after shell or logs?
A normal exit is not a crash. The board announces leave, then resumes so you can hit the next verb.
How do I move without the mouse?
j/k or arrows move the cursor. Enter opens a fleet folder or execs the selected stack row.

Broke something?report it