gb setup

Configure user preferences for AI credentials, GitHub, and defaults.

Synopsis


gb setup [options]

Description

Interactive setup wizard that configures your preferences for remote genbox creation. This includes syncing AI CLI credentials (Claude, Gemini), GitHub tokens for private repos, and default settings.

Options

Option	Description
`--show`	Show current configuration
`--ai`	Configure AI credentials only
`--github`	Configure GitHub token only
`--defaults`	Configure defaults only (AI provider, genbox size)
`--clear`	Clear all preferences

Examples

Full Setup


gb setup

Runs the complete setup wizard:


Genbox Setup
Configure your preferences for remote genbox creation.

1. AI Credentials
Sync local CLI credentials to enable remote genbox creation.

Claude CLI: found locally | Server: not synced
? Sync Claude credentials to server? Yes
  ✓ Claude credentials will be synced

Gemini CLI: found locally | Server: configured
? Update Gemini credentials on server? No

2. GitHub Token
Required for cloning private repositories.

Current: not configured
? Configure GitHub token? Yes
GitHub Personal Access Token: ****
  ✓ GitHub token will be saved

3. Default Settings
Defaults used when creating new genboxes.

? Default AI provider: Claude (recommended)
? Default genbox size: Medium (4 vCPU, 8GB)

✓ Setup complete!

Show Current Configuration


gb setup --show


Current Preferences

AI Credentials:
  Claude:  configured
  Gemini:  configured
  OpenAI:  not configured

GitHub:
  Token:   ghp_****...

Defaults:
  AI Provider:   claude
  Genbox Size:   medium

Last updated: 1/2/2025, 10:30:00 AM

Configure Only AI Credentials


gb setup --ai

Only prompts for Claude and Gemini credential sync.

Configure Only GitHub Token


gb setup --github

Only prompts for GitHub Personal Access Token.

Configure Only Defaults


gb setup --defaults

Only prompts for default AI provider and genbox size.

Clear All Preferences


gb setup --clear


? Are you sure you want to clear all preferences? Yes
✓ All preferences cleared

AI Credential Sources

The setup command detects local AI CLI credentials from:

Platform	Claude Location	Gemini Location
macOS	Keychain (`Claude Code-credentials`)	`~/.gemini/credentials.json`
Linux	`~/.claude/.credentials.json`	`~/.gemini/credentials.json`

Security

Credentials are encrypted with AES-256-GCM before storage
API returns "configured" status, never actual tokens
Uses your existing Claude Code/Gemini subscription (no double-billing)
Credentials are injected into genboxes via secure cloud-init

Why Sync Credentials?

When you create a cloud genbox, it needs access to AI CLIs. By syncing your credentials:

Claude Code / Gemini CLI are pre-authenticated on your genbox
No manual login required on remote environments
Your existing subscription is used (Pro/Max/etc.)

Notes

Run claude locally first to generate Claude credentials
Run gemini locally first to generate Gemini credentials
GitHub tokens need repo scope for private repositories
Preferences persist across CLI sessions