gitarsenal [project]           Start GitArsenal TUI (default command)
gitarsenal acp                  Start ACP (Agent Client Protocol) server
gitarsenal attach <url>          Attach to a running GitArsenal server
gitarsenal workspace <action>   Manage GPU workspaces
gitarsenal run [message..]       Run GitArsenal with a message
gitarsenal auth                  Manage credentials
gitarsenal agent                 Manage agents
gitarsenal upgrade [target]      Upgrade GitArsenal to latest or specific version
gitarsenal serve                 Start a headless GitArsenal server
gitarsenal web                   Start a headless opencode server
gitarsenal models [provider]    List all available models
gitarsenal stats                 Show token usage and cost statistics
gitarsenal export [sessionID]    Export session data as JSON
gitarsenal import <file>         Import session data from JSON file or URL
gitarsenal github                Manage GitHub agent
gitarsenal pr <number>           Fetch and checkout a GitHub PR branch, then run opencode

# Help and Version
-h, --help              Show help message
-v, --version           Show version number

# Logging Options
--print-logs            Print logs to stderr
--log-level <level>     Set log level (DEBUG, INFO, WARN, ERROR)

# Model and Agent Options
-m, --model <provider/model>    Model to use (e.g., openai/gpt-4)
--agent <name>                  Agent to use

# Session Management
-c, --continue                  Continue the last session
-s, --session <id>              Session ID to continue
-p, --prompt <text>             Prompt to use

# Server Configuration
--port <number>                 Port to listen on (default: 0)
--hostname <address>             Hostname to listen on (default: 127.0.0.1)
--server <mode>                  Server mode: local, modal, or remote (default: local)
--url <address>                  Remote server URL when --server=remote (default: 127.0.0.1)

# Positional Arguments
<project>                       Path to start GitArsenal in

# Start interactive TUI (default)
gitarsenal

# Start in a specific project directory
gitarsenal /path/to/project

# Run with a specific message
gitarsenal run "Set up this repository with GPU support"

# Continue previous session
gitarsenal --continue

# Use specific model
gitarsenal --model openai/gpt-4

# Start in server mode
gitarsenal serve --port 8080

# Attach to remote server
gitarsenal attach https://remote-server.com

# Manage workspaces
gitarsenal workspace list
gitarsenal workspace create my-workspace

# Export session data
gitarsenal export session-123

# Import session data
gitarsenal import session-data.json

# Check GitHub PR
gitarsenal pr 42