← Projects

boxwarden

A desktop app for local dev container management. Lists the dev containers on your machine, reattaches your editor to them, and opens a shell inside them.

Preview

Built with

Electron · React · TypeScript · Dockerode · Vite · Bun

Overview

boxwarden is a cross-platform Electron desktop app that gives dev containers a home outside the editor. It lists every container carrying the devcontainer.local_folder label, shows the project, host folder, image, state, health, ports, and the git branch each workspace is checked out on, and lets you start, stop, attach an editor, or open a shell without touching the command line. It talks to every container engine that answers - Docker Desktop, OrbStack, Colima, Rancher Desktop, rootless Docker, and Podman - and merges their lists into one view. When an engine cannot be reached, it names every socket it tried, why each one failed, and where possible the exact command that fixes it.

Highlights

  • Lists dev containers with project, host folder, image, state, health, and published vs. exposed-only ports
  • Shows the git branch each workspace is on, so identical repo names are distinguishable
  • Flags containers with a Claude Code session running inside before you stop them
  • Opens containers in VS Code, VS Code Insiders, Cursor, or Windsurf, and marks which is already attached
  • Opens a shell in your own terminal emulator, with a remembered per-container startup command
  • Scans your folders for devcontainer.json to surface projects you have not built yet
  • Connects to Docker Desktop, OrbStack, Colima, Rancher Desktop, rootless Docker, and Podman at once
  • Diagnoses failed engine connections socket by socket, with the command that fixes each one
  • Cosign-signed releases with SLSA provenance, OpenSSF Scorecard tracked, MIT licensed