Documentation
📘 Commands

RF Swift Command Reference

RF Swift Command Reference

Complete reference for all RF Swift commands. Each command has its own dedicated page with syntax, options, and examples.

Quick Help: Use rfswift [command] --help for instant command help.
🧙
Interactive Mode: Most RF Swift commands feature interactive TUI pickers when run without required flags in a terminal. For example, rfswift run (without -i and -n) launches a guided wizard, and rfswift exec (without -c) shows a container picker. All interactive features gracefully degrade to standard CLI flags when scripting or piping.

🔌 Global Flags

Disconnected Mode

All RF Swift commands support the -q or --disconnect flag to disable update checks when working offline or in air-gapped environments:

# Work without querying for updates
rfswift -q run -i sdr_full -n work
rfswift --disconnect last
rfswift -q images local

# Useful for:
# - Offline/air-gapped systems
# - Avoiding network delays
# - Scripting/automation
# - Systems behind firewalls

When disconnected mode is enabled, RF Swift skips checking for new versions and runs immediately without any network queries. All functionality remains available - only the update notification system is disabled.

📋 Command Categories

🐳 Container Management

run
Create and start a new container
 profile
Manage container profiles (presets)
 exec
Execute commands in a running container
 stop
Stop a running container
 remove
Remove a container
 rename
Rename a container
 commit
Save container as new image

🖼️ Image Management

images
Manage RF Swift images (pull, list, search)
 build
Build image from YAML recipe
 delete
Delete an image
 retag
Rename an image tag
 download
Download and save image to tar.gz
 import
Import containers or images
 export
Export containers or images

⚙️ Dynamic Configuration

bindings
Manage device and volume bindings
 capabilities
Manage Linux capabilities
 cgroups
Manage cgroup device rules
 gpus
Manage GPU passthrough
 ports
Manage container ports

📹 Session Recording & Reporting

log
Record and replay terminal sessions
 report
Generate assessment reports

🔧 System Operations

host
Host system configuration
 doctor
Diagnose system environment
 update
Update RF Swift binary
 completion
Generate shell completion scripts
 install
Install helper scripts

🎚️ Performance & Resources

realtime
Enable/disable realtime SDR mode
 ulimits
Manage container resource limits
 engine
Show or set container engine

🌐 Networking

network
Manage NAT networks for container isolation

🛠️ Utilities

last
Show recently used containers
 cleanup
Clean up old containers and images
 upgrade
Upgrade container to new image

🪟 Windows (WSL2)

winusb
Manage USB devices in WSL2

🍎 macOS (Lima)

macusb
Manage USB devices via Lima VM

🚀 Quick Reference

Command Purpose
rfswift run -i IMAGE -n NAME Create new container
rfswift run --profile PROFILE -n NAME Create container from profile
rfswift profile list List available profiles
rfswift profile init Generate default profiles
rfswift exec -c CONTAINER Enter container
rfswift last List recent containers
rfswift bindings add -c CONTAINER -d -t DEVICE Add device
rfswift capabilities add -c CONTAINER -a CAP Add capability
rfswift ports bind -c CONTAINER -p PORT Bind port
rfswift images pull -i IMAGE Download image
rfswift build -r RECIPE.yaml Build from recipe
rfswift log replay -i FILE.cast Replay session
rfswift run --vpn tailscale Create container with VPN
rfswift exec --vpn tailscale Enter container with VPN
rfswift --engine podman run Use Podman engine
rfswift doctor Diagnose environment
rfswift update Update RF Swift
rfswift gpus add -c CONTAINER Add GPU passthrough
rfswift realtime enable -c CONTAINER Enable realtime SDR mode
rfswift images versions List available image versions
rfswift cleanup all --dry-run Preview cleanup actions
rfswift winusb list List USB devices (Windows/WSL2)
rfswift macusb list List USB devices (macOS)
rfswift --engine lima run Run container with USB (macOS)
rfswift engine lima status Show Lima VM status (macOS)
rfswift engine lima reconfig Reconfigure Lima VM (macOS)
rfswift engine lima reset Reset Lima VM from scratch (macOS)
rfswift network list List NAT networks
rfswift network create -n NAME Create isolated NAT network
rfswift network cleanup Remove orphaned networks
rfswift report generate -c NAME Generate assessment report
rfswift report generate -c NAME -f html HTML report

🆘 Getting Help 

rfswift --help              # All commands
rfswift run --help          # Specific command
rfswift bindings add --help # Subcommand
💡
New to RF Swift? Start with the Quick Start Guide before diving into command details.
Last updated on
🛠️ Container Scriptsrun