bushel Printed matter · Issue 0.3.6

A terminal UI for Apple Containers · macOS 26

1 bushel = 4 panes = 2 layouts = 1 binary

bushel is a terminal UI for Apple's container CLI. Browse containers, images, volumes and networks in four panes, watch live telemetry on the one you've picked, and read every destructive command before it runs.

curl -LsSf https://bushel.sh/install | sh

No Homebrew needed More ways to take one

Sec. 01 · Packing list

What's in the bushel

Create containers with Apple's CLI, then manage them here. Pull and tag images, make named volumes, and inspect the networks you already have.

  • 4 panes

    Containers, images, volumes and networks, all in one window.

  • 2 layouts

    A rail beside the detail pane, or the table at full width. Press , for settings to switch.

  • 1 confirmation

    Delete, prune and kill print the exact container command before anything runs.

  • 150 ms, tops

    Every animation yields to input and none of it delays a keystroke. --reduced-motion turns it all off.

  • 0 leaks

    bushel owns its logs -f tails and kills them when a container stops.

  • 1 key to a shell

    Press e. bushel steps aside for container exec -it, then puts the layout back.

Sec. 02 · Fig. A

The actual thing

A recorded session, printed in two inks. It plays muted, and stops when you scroll past it.

  1. the rail: every pane, and the one you're on
  2. live cpu and memory for the selection
  3. the log tail, following. F and w toggle follow and wrap.
  4. the keys that matter right now, always on screen
Using bushel

One binary on top of Apple's container CLI. For macOS 26 on Apple silicon, tested with container 1.2.x. Upgrade any time with bushel update.

Please take one

Sec. 03 · Take one

Three ways in

Shell Start here

curl -LsSf https://bushel.sh/install | sh

Homebrew

brew install frankieramirez/tap/bushel

Cargo

cargo install bushel

bushel warns on container versions it hasn't been tested against, but still runs. Install prefixes, completions and the man page are in the install docs.

Sec. 04 · Contents

The rest is in the docs

  1. 01 Overview What bushel is, and where to go next.
  2. 02 Install Install, upgrade, shell completions, and the man page.
  3. 03 Using bushel Navigate the panes and work with containers, images, volumes and networks.
  4. 04 Keys The generated cheatsheet and controls for dialogs and settings.
  5. 05 Config Layouts, saved settings, and the flags that override the file.
  6. 06 Troubleshooting What to do when bushel will not start, connect, or draw.
  7. 07 Why Why a TUI for Apple Containers, and the arguments behind its shape.
  8. · Roadmap What's shipped and what's still to come.