Command Cookbook

Task-oriented command recipes you can copy, adapt, and automate.

Session Lifecycle

bmux new-session dev bmux attach dev bmux list-sessions --json

Remote Target Workflow

bmux remote list --json bmux remote test prod bmux connect prod app

Hosted Flow

bmux setup --mode p2p bmux host --status bmux hosts

Kiosk Access Flow

bmux kiosk status bmux kiosk init --all-profiles --dry-run bmux kiosk init --all-profiles bmux kiosk issue-token demo bmux kiosk revoke-token <token-id>
For profile design, SSH forced-command examples, and security semantics, see Kiosk Access.

Logging and Diagnostics

bmux logs path --json bmux logs level --json bmux logs tail --since 15m --lines 200 --no-follow

Ephemeral Sandbox Workflow

# Run a bmux command in a clean isolated sandbox bmux sandbox run -- server status # Dev shortcut (keep artifacts on failures, prefers ./target/debug/bmux when present) bmux sandbox dev -- server status # Test a specific local bmux build in isolation bmux sandbox run --bmux-bin ./target/debug/bmux -- attach # Keep artifacts/logs for debugging a failing sandbox run bmux sandbox run --keep --bmux-bin ./target/debug/bmux -- server start # Override to inherit parent environment instead of clean mode bmux sandbox run --env-mode inherit -- server status # More strict mode with minimal inherited environment bmux sandbox run --env-mode hermetic -- server status # Kill long-running sandbox command after 45 seconds bmux sandbox run --timeout 45 -- server start # Print resolved sandbox env map for reproducibility bmux sandbox run --print-env -- server status # Discover recent sandboxes and inspect one bmux sandbox list --limit 10 bmux sandbox status --json bmux sandbox list --source playbook --limit 10 bmux sandbox inspect bmux-sbx-123 --tail 120 bmux sandbox inspect --latest bmux sandbox inspect --latest --source recording-verify bmux sandbox inspect --latest-failed --tail 120 bmux sandbox tail --latest-failed --tail 120 --json bmux sandbox open --latest-failed --json bmux sandbox rerun --latest-failed --bmux-bin ./target/debug/bmux --json bmux sandbox triage --json bmux sandbox triage --latest-failed --source playbook --tail 120 --json bmux sandbox triage --latest-failed --rerun --bmux-bin ./target/debug/bmux # Health checks for sandbox runtime bmux sandbox doctor --json bmux sandbox doctor --fix --dry-run --json bmux sandbox doctor --fix --json # Bundle diagnostics and logs for sharing bmux sandbox bundle bmux-sbx-123 --output ./sandbox-artifacts bmux sandbox bundle bmux-sbx-123 --json bmux sandbox bundle bmux-sbx-123 --include-env --include-index-state --include-doctor --json bmux sandbox bundle bmux-sbx-123 --include-env --verify --json bmux sandbox verify-bundle ./sandbox-artifacts/bmux-sbx-123-1700000000000 --json bmux sandbox verify-bundle ./sandbox-artifacts/bmux-sbx-123-1700000000000 --strict --json # One-shot triage + bundle + verify bmux sandbox triage --latest-failed --bundle --bundle-output ./sandbox-artifacts --json # Strict one-shot triage verify (fails on unexpected extras too) bmux sandbox triage --latest-failed --bundle --bundle-strict-verify --json # Clean up orphaned sandbox directories bmux sandbox cleanup --dry-run --json bmux sandbox clean --dry-run --json bmux sandbox cleanup --failed-only --older-than 600 bmux sandbox cleanup --all-status --source playbook --older-than 0 bmux sandbox cleanup --source recording-verify --older-than 600 bmux sandbox rebuild-index --json
# Inspect per-entry cleanup reasons quickly bmux sandbox cleanup --dry-run --older-than 0 --json | jq '.entries[] | {path, reason, status, source}' # Inspect auto-heal reconcile stats bmux sandbox status --json | jq '.reconcile' # Inspect verify drift fields quickly bmux sandbox verify-bundle ./sandbox-artifacts/bmux-sbx-123-1700000000000 --json | jq '.issues[] | {path, field, expected, actual}' # Inspect unexpected extras and version compatibility bmux sandbox verify-bundle ./sandbox-artifacts/bmux-sbx-123-1700000000000 --json | jq '{ok, strict, unexpected_artifacts, version_check}' # Check triage bundle verify result and strict mode bmux sandbox triage --latest-failed --bundle --json | jq '.bundle.verify | {ok, strict, issue_count, mode}'

Sandbox Daily Loop

# 1) Validate your local build in isolation bmux sandbox dev --bmux-bin ./target/debug/bmux -- server status # 2) Re-check the most recent failed run bmux sandbox inspect --latest-failed --tail 200 # 3) Package logs + repro metadata for teammates bmux sandbox bundle bmux-sbx-123 --output ./sandbox-artifacts

Sandbox Triage (Operator Quickstart)

# Status first: totals + source mix + reconcile auto-heal counters bmux sandbox status --json # Narrow to the failure you care about bmux sandbox tail --latest-failed --tail 120 --json bmux sandbox open --latest-failed --json bmux sandbox tail --latest-failed --source recording-verify --tail 120 --json # Reproduce from manifest command metadata bmux sandbox rerun --latest-failed --bmux-bin ./target/debug/bmux --json # Repair stale state safely bmux sandbox doctor --fix --dry-run --json bmux sandbox doctor --fix --json
# Quick check: did reconcile auto-heal anything? bmux sandbox status --json | jq '.reconcile | {healed_entries, rebuilt_entries, pruned_entries, normalized_running, cleared_stale_locks}' # Quick check: inspect only failed playbook sandboxes bmux sandbox tail --latest-failed --source playbook --tail 200 --json | jq '{id, source, status, latest_log, log_tail}'