Power User Shortcuts

Genbox CLI provides shorthand commands for power users who want faster access to common operations.

Overview

All shortcuts follow the pattern gb<letter> where the letter represents the provider or command:

Letter	Provider/Command
`c`	Claude
`g`	Gemini
`x`	Codex
`o`	OpenCode
`r`	Cursor
`s`	Session

Adding d at the end enables --direct mode (no isolation).

Provider Shortcuts

Start AI sessions with a single command:

Shortcut	Equivalent	Description
`gbc`	`gb claude`	Start Claude AI session
`gbg`	`gb gemini`	Start Gemini AI session
`gbx`	`gb codex`	Start Codex AI session
`gbo`	`gb opencode`	Start OpenCode AI session
`gbr`	`gb cursor`	Start Cursor AI session
`gbs`	`gb session`	Session management

Direct Mode Shortcuts

Run sessions directly on your machine without container/VM isolation:

Shortcut	Equivalent	Description
`gbcd`	`gb claude --direct`	Claude without isolation
`gbgd`	`gb gemini --direct`	Gemini without isolation
`gbxd`	`gb codex --direct`	Codex without isolation
`gbod`	`gb opencode --direct`	OpenCode without isolation
`gbrd`	`gb cursor --direct`	Cursor without isolation
`gbsd`	`gb session --direct`	Session without isolation

Usage Examples

Quick Start


# Start Claude session (interactive genbox selection)
gbc
 
# Start Claude directly on your machine
gbcd
 
# Start Gemini session
gbg
 
# List all sessions
gbs list

With Additional Options

Shortcuts accept all the same options as the full commands:


# Use specific genbox
gbc --on my-genbox
 
# Prompt mode with editor
gbc -p -e
 
# Background session
gbc -p -b
 
# Session management
gbs list --cloud
gbs watch

Direct Mode Workflow

Direct mode (*d shortcuts) is ideal for:

Quick local development without isolation overhead
Testing on your own machine
When you trust the AI agent fully


# Quick Claude session on your machine
gbcd
 
# Direct Gemini session
gbgd
 
# Direct session management
gbsd

When to Use Shortcuts

Use shortcuts when:

You’re frequently starting AI sessions
You want faster command entry
You’re comfortable with the CLI

Use full commands when:

You need to see all available options (--help)
You’re scripting or documenting
You’re new to the CLI

Shell Completion

Shortcuts work with shell completion. After installing completions:


# Install completions
gb completion bash >> ~/.bashrc   # Bash
gb completion zsh >> ~/.zshrc     # Zsh
gb completion fish >> ~/.config/fish/completions/gb.fish  # Fish
 
# Now tab-complete works
gbc <TAB>     # Shows available options
gbs <TAB>     # Shows subcommands