Commands Overview

The Genbox CLI provides a comprehensive set of commands for managing cloud development environments and AI sessions.

Command Structure


gb <command> [arguments] [options]

Both genbox and gb are valid entry points. Use gb for brevity.

Command	Shortcut	Description
`session`	`gbs`	Manage AI sessions (list, watch, logs, send)
`claude`	`gbc`	Start or attach to Claude AI session
`gemini`	`gbg`	Start or attach to Gemini AI session
`codex`	`gbx`	Start or attach to Codex AI session (Coming Soon)
`opencode`	`gbo`	Start or attach to OpenCode AI session (Coming Soon)
`cursor`	`gbr`	Start or attach to Cursor AI session (Coming Soon)

Tip: Add d to any shortcut for --direct mode (e.g., gbcd = gb claude --direct)

See Shortcuts Reference for all shortcuts.

Command	Description
`create`	Create a new Genbox environment
`list`	List all environments
`destroy`	Delete an environment
`connect`	SSH into an environment
`status`	Check status and services

Command	Description
`start`	Start a stopped environment
`stop`	Stop (pause) an environment
`restart`	Restart services
`extend`	Extend lifetime / disable auto-destroy
`rebuild`	Rebuild with updated config

Command	Description
`urls`	Show service URLs
`forward`	Set up port forwarding
`push`	Push local changes
`run-prompt`	Run Claude Code prompt remotely

Command	Description
`db sync`	Sync database from staging/production
`restore-db`	Restore local MongoDB to environment
`backup`	Create a backup
`backups`	List and manage backups

Command	Description
`init`	Initialize genbox.yaml
`config`	Inspect configuration
`profiles`	Manage profiles
`resolve`	Compute final configuration
`validate`	Validate configuration files

Command	Description
`login`	Authenticate with Genbox
`balance`	Show credit balance

Command	Description
`help`	Show detailed help and examples
`doctor`	Check CLI setup and diagnose issues
`update`	Update CLI to latest version
`completion`	Generate shell completions

All commands support these global options:


-v, --version    Show version and status info
-h, --help       Show help for command
--debug          Enable debug output

For any command, add --help to see detailed usage:


gb create --help
gb status --help

For interactive help with examples:


gb help
gb help create