🟧📦 squarebox

Modern CLI/TUI tools and AI coding assistants in a portable development Box.

Run the same terminal environment on your desktop, server, or Codespace. One-line install, interactive setup, and persistent tools and settings.

Install

Requires Docker or Podman, plus Git (Git for Windows). The installer detects your runtime and asks which to use if both are installed. Need Docker?

Linux / macOS / Git Bash

curl -fsSL https://github.com/SquareWaveSystems/squarebox/releases/latest/download/install.sh | bash

Windows (PowerShell 7+)

irm https://github.com/SquareWaveSystems/squarebox/releases/latest/download/install.ps1 | iex

The installer pulls the latest stable Release and sets up ~/squarebox. First login runs a wizard for Git identity, GitHub sign-in, and optional tools. Keep using the same adapter (Bash/Git Bash or PowerShell) for updates and uninstall.

For edge builds, custom paths, scripted setup, or Windows flags, see the usage reference. Upgrading? Check the migration guides and changelog.

Start

squarebox        # or: sqrbx

Your code lives in ~/squarebox/workspace, mounted at /workspace. Shell history, credentials, assistant data, and SDKs live in the persistent squarebox-home volume. Both survive Box replacement. Selected system packages are reinstalled automatically; manually installed system packages are lost.

For a persistent server or NAS, see server deployment. For VS Code or GitHub Codespaces, see Dev Containers and Codespaces.

What's included

CLI Tools