CLI Module¶

Command-line interface for Shannot.

Overview¶

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

Commands¶

shannot setup¶

Install PyPy stdlib for sandboxing.

shannot setup              # Install runtime
shannot setup --force      # Force reinstall
shannot setup --status     # Check if installed
shannot setup --remove     # Remove runtime

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 execute¶

Execute a previously created session.

shannot execute --session-id SESSION_ID
shannot execute --session-id SESSION_ID --json-output

shannot remote¶

Manage SSH remote targets.

shannot remote add NAME [USER@]HOST    # Add target
shannot remote list                     # List targets
shannot remote test NAME                # Test connection
shannot 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 mcp¶

MCP server management.

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