CLI Module¶

Command-line interface for Shannot.

Overview¶

The CLI provides commands for sandbox execution, session approval, and system management.

Commands¶

shannot setup¶

Interactive setup menu or configuration subcommands.

shannot setup                      # Interactive setup menu
shannot setup runtime              # Install runtime
shannot setup runtime --force      # Force reinstall
shannot setup runtime --status     # Check if installed
shannot setup runtime --remove     # Remove runtime
shannot setup remote               # Interactive remote management
shannot setup mcp                  # Interactive MCP setup

shannot run¶

Execute a Python script in the PyPy sandbox.

shannot run script.py                    # Basic execution
shannot run script.py --tmp=/tmp/work    # Map real directory to /tmp
shannot run script.py --dry-run          # Queue without executing
shannot run script.py --target prod      # Execute on remote

Options:

Option	Description
`--pypy-sandbox PATH`	Path to pypy-sandbox executable
`--lib-path PATH`	Path to lib-python and lib_pypy
`--tmp DIR`	Real directory mapped to virtual /tmp
`--dry-run`	Log commands without executing
`--target NAME`	SSH target for remote execution
`--debug`	Enable debug mode

shannot approve¶

Interactive TUI for reviewing and approving sessions.

shannot approve                    # Launch TUI
shannot approve list               # List pending sessions
shannot approve show SESSION_ID    # Show session details
shannot approve history            # Show recent sessions

TUI Controls:

Key	Action
`j/k` or arrows	Navigate
`Enter`	View details / Execute
`Space`	Toggle selection
`x`	Execute selected
`r`	Reject selected
`q` / `Esc`	Quit

shannot setup remote¶

Manage SSH remote targets.

shannot setup remote add NAME [USER@]HOST    # Add target
shannot setup remote list                     # List targets
shannot setup remote test NAME                # Test connection
shannot setup remote remove NAME              # Remove target

shannot status¶

Show system health and configuration.

shannot status             # Full status
shannot status --runtime   # Runtime only
shannot status --targets   # Remote targets only

shannot setup mcp¶

MCP server management.

shannot setup mcp install                         # Install for Claude Desktop
shannot setup mcp install --client claude-code    # Install for Claude Code

shannot rollback¶

Rollback session changes to pre-execution state.

shannot rollback <session_id>           # Rollback with conflict check
shannot rollback <session_id> --force   # Skip conflict detection
shannot rollback <session_id> --dry-run # Preview without making changes

Arguments:

Argument	Description
`session_id`	Session ID to rollback