guide / installยท 2026-08-15

One curl. Then source your shell.

Needs bash 4+ and Docker (Colima or Desktop). Release kits and Homebrew include the clickable TUI (logo splash, start/shell/stop first). A source install builds it when Go is on PATH; otherwise you get the bash menu.

Safer than piping curl: clone the repo, then bash install.sh. Each person needs their own Docker/Colima.

curl -fsSL https://raw.githubusercontent.com/Brasth/dc-cli/main/install.sh | bash
source ~/.zshrc   # or ~/.bashrc

Or Homebrew (same kit, no Go):

brew tap Brasth/dc-cli
brew install dc-cli

Flags

Flag What you get
(default) wrappers in ~/bin only โ€” not the official CLI
--with-cli npm i -g @devcontainers/cli if missing
--with-skill copy the agent skill into homes you already have
--full --with-cli + --with-skill
--ref v0.4.3 / main pin a tag or use HEAD

Default install does not put devcontainer on PATH. Add --with-cli if you do not already have official @devcontainers/cli.

Skill

--with-skill copies the devcontainer-cli-global skill into agent homes you already have. It does not install Claude / Codex / Cursor for you. Restart the agent after.

--full is --with-cli + --with-skill.

Homes and the exact copy list live in the README Skill section.

Confirm: dc-tui --help or dc-up --help should print usage.

Daily start

Run from your project folder (the one with .devcontainer):

cd /path/to/your/project
dc-tui

Or skip the board: dc-up, then dc-exec.

Full flag tables live in the README commands.

Broke something?report it