Sandboxes in the TUI and macOS app

Watch and manage OpenShell sandboxes from the DefenseClaw terminal UI's Sandboxes panel or the macOS app's Sandboxes view, menu bar and notifications, and run sandbox setup from either.

Watch the live feed, answer asks, unblock sites, and stop, pull or undo a sandbox from the TUI or the macOS app. Both read the DefenseClaw daemon, so a sandbox started from the command line shows up in both. Sandboxes must be set up and the daemon running. On Windows the panel only says that OpenShell sandboxes run on Linux and macOS.

TaskCommand lineTUI (7)macOS app
Start a runsandbox run claudenCopy run command
Watch the feedsandbox activity -ft for ActivityActivity, plus notifications
Unblock a sitesandbox unblock HOSTuUnblock
Answer an asksandbox approve NAME IDa, A, x in AsksApprove, Always…, Reject
Bring back a copysandbox pull NAME --applyPPull to branch
Undosandbox undo NAMEUUndo…

The TUI Sandboxes panel

defenseclaw tui

Press 7 for the Sandboxes panel. The header shows the state (READY, OFF, WAITING, UNAVAILABLE or UNREACHABLE), how many sandboxes run, how many asks wait, and the gateway with its driver. OFF points to the setup wizard. UNAVAILABLE gives the daemon's reason.

DefenseClaw TUI Sandboxes panel on a Mac: READY, one running sandbox and two asks waiting on the OpenShell 0.1.5 gateway (MicroVM), the unblock hint for a refused paste site, the button bar, and the myapp-claude row with its pack, copy mode, sites, blocks, tool calls and alerts

Press t to switch views: Sandboxes (one row per sandbox), Activity (the live feed, newest first) and Asks (waiting for you). Enter opens details, Esc closes them.

DefenseClaw TUI Activity view on Linux: the feed of one sandbox, newest first, with allowed sites, two shadow AI warnings, a paste site refused with the key that unblocks it, a blocked tool call and the sandbox's lifecycle lines

~/code/myapp
Recorded on DefenseClaw 1.0.4 from a real Claude Code sandbox on a Mac (MicroVM, copy mode). ⚠ shadow AI is the finding, each ✗ line for a refused site ends with the command that lifts the block, the ? line is an ask waiting for you, and the ⚠ Bash allowed but flagged line is a tool call that DefenseClaw's hooks recorded and allowed (the default pack observes). The 1.0.3 recording ended with a blocked tool call; the default pack in 1.0.4 allows and flags it instead.

DefenseClaw TUI Asks view on Linux: sandbox svc asks to reach host port 9418 (git) on the OpenShell 0.1.5 gateway (docker driver) and waits for an answer

Keys

KeyAction
nStart a new sandboxed run
cConnect: start a stopped sandbox and attach its harness
s / dStop (kept) or delete the sandbox, after asking
R / PReview changed files (live mount), or pull a copy's work
UUndo the pre-session snapshot, or the last pull on a copy
uUnblock a blocked site, for this sandbox or all
a / A / xApprove an ask once, always, or reject it
wTurn the shell wrapper on or off per harness

The KEYS line at the bottom lists the keys that apply to the selected row. Blocks of private networks, metadata addresses and your organization's block lists cannot be lifted here.

Sandbox details

DefenseClaw TUI sandbox details on Linux: a mounted project, sites contacted and blocked, hook event counts, the last tool block (C2-METADATA-AWS), and one row per destination: the model provider, two shadow AI sites, package registries, source hosting and a refused paste site

DefenseClaw TUI sandbox details on a Mac in copy mode: asks waiting, the process tree from OpenShell's runtime through the DefenseClaw supervisor and Claude Code to a rate-limited curl, the pull and undo actions, and the destinations

defenseclaw sandbox ps myapp-claude --tree on Linux: OpenShell's runtime as the root, a login shell, the DefenseClaw supervisor, Claude Code, a shell it started and the rate-limited curl under that shell

~/code/myapp
Recorded on DefenseClaw 1.0.4 from a real Claude Code copy-mode sandbox named myapp-a84c on RHEL 9 with the process tree on and a model key from Amazon Bedrock. api.openai.com is shadow AI, pastebin.com was refused by the blocklist, and the BINARY column shows the program that connected. In 1.0.4 the BINARY column shows the program only (/usr/bin/curl); the parent chain (curl ← bash ← claude) from earlier builds did not appear here.
~/code/myapp
Recorded on DefenseClaw 1.0.4 from a real Claude Code sandbox on a Mac, started with --process-tree, while a rate-limited curl ran: curl under bash under claude. In 1.0.4 each process prints as a block (pid, ppid, up, command) with the command indented by its depth, not as a table.

Start a run from the TUI

n opens the launch dialog: harness, project folder, optional name, network profile, work on a copy (ticked and locked on a Mac), and keep the harness's prompts (--safe). Ctrl+S starts it and the TUI hands over your terminal until the harness exits.

DefenseClaw TUI New sandboxed run dialog on a Mac: harness, project folder, name, network profile, work on a copy, keep the harness's own permission prompts

The macOS app

The Sandboxes view

The macOS app shows sandboxes in the Sandboxes view (under Govern, or ⌘⇧B), the menu bar and notifications. It refreshes every few seconds. The view has a table of sandboxes, a list of waiting asks and the 60 newest events.

Sandbox details and actions

Each selected sandbox offers Stop…, Copy pull command, Pull to branch, Review changes, Undo… and Copy connect command. The app has no launch dialog: start runs in Terminal.

With Notify on sandbox blocked destinations and asks on in the app's settings, you get a notification for a blocked site (Unblock for this sandbox), an ask, a new git repository in a mounted project, and hooks that cannot reach DefenseClaw. At most one arrives per sandbox and site per minute. Unblocking a site everywhere is a confirmed choice in the Sandboxes view.

Check it worked

Run defenseclaw sandbox run claude in a terminal. The sandbox appears in the TUI Sandboxes panel or the app within a few seconds, and its sites appear in Activity.

Next