Setup wizard

xibecode setup walks you through first-time configuration: LLM provider + API key, optional 24/7 messaging gateway, and agent defaults.

Commands

# Full wizard (model → gateway → agent)
xibecode setup

# Sections only
xibecode setup model
xibecode setup gateway
xibecode setup agent

# Model + Telegram only
xibecode setup --quick

# Print flags/env guidance (CI / headless)
xibecode setup --non-interactive

Requires an interactive TTY for the numbered menus. In CI, use config flags instead (see Non-interactive).

What it configures

1. Model & provider (setup model)

1. Numbered provider list — full XibeCode catalog (Routing.run, zenllm.org, Anthropic, OpenAI, OpenRouter, DeepSeek, Gemini, Grok, Z.AI, Kimi, MiniMax, Fireworks, Novita, local LM Studio, Azure Foundry, and more).
2. API key — stored in your profile (~/.xibecode/…/profile-*.json).
3. Default model — provider presets or custom id.
4. Base URL — optional override for proxies / OpenAI-compatible endpoints.
5. Request format — OpenAI or Anthropic wire format from the provider preset.
6. Mirrors the key into ~/.xibecode/gateway.env for the systemd gateway service.

See Providers for the full table.

2. 24/7 gateway (setup gateway)

Optional Telegram (and Discord/Slack via env) configuration:

• Writes TELEGRAM_BOT_TOKEN, TELEGRAM_ALLOWED_USERS, etc. to ~/.xibecode/gateway.env
• Can install and start the systemd user service for always-on coding from chat

See 24/7 gateway for start/stop commands and pairing.

3. Agent defaults (setup agent)

• Working directory preferences
• Max iterations — 0 means unlimited (recommended for long autonomous tasks; you can still abort with Ctrl+C or gateway /stop)
• Cost mode and related caps

Non-interactive / CI

xibecode config --set-key YOUR_API_KEY
xibecode config --set-provider anthropic
xibecode config --set-model claude-sonnet-4-6
xibecode config --show

Gateway without the wizard:

# Edit ~/.xibecode/gateway.env
TELEGRAM_BOT_TOKEN=...
TELEGRAM_ALLOWED_USERS=your_user_id
ANTHROPIC_API_KEY=...   # or provider-specific key

xibecode gateway --install --workdir /path/to/repo
xibecode gateway --start

Related

Note: CLI xibecode setup is the full onboarding path. Chat slash /setup only updates the active chat profile for that session.