Setup wizard
Interactive xibecode setup for API providers, 24/7 gateway, and agent defaults.
Setup wizard
xibecode setup walks you through first-time configuration: LLM provider + API key, optional 24/7 Xibe Daemon (Telegram / Discord / Slack), 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-interactiveRequires an interactive TTY for the numbered menus. In CI, use config flags instead (see Non-interactive).
What it configures
1. Model & provider (setup model)
- 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, models.dev-backed catalogs, and more).
- API key — stored in your profile (
~/.xibecode/profile-*.json). - Default model — provider presets or custom id.
- Base URL — optional override for proxies / OpenAI-compatible endpoints.
- Request format — OpenAI or Anthropic wire format from the provider preset.
- Mirrors the key into
~/.xibecode/daemon.env/gateway.envfor the always-on daemon.
See Providers for the full table.
2. 24/7 daemon (setup gateway)
Optional Telegram (and Discord/Slack via env) configuration:
- Writes
TELEGRAM_BOT_TOKEN,TELEGRAM_ALLOWED_USERS, etc. to~/.xibecode/daemon.env(orgateway.env) - Can install and start the systemd user service (
xibecode-daemon) for always-on coding from chat
CLI primary command is xibecode daemon (xibecode gateway is an alias). See Xibe Daemon for /cmd, /update, steer mode, media, start/stop, and pairing.
3. Agent defaults (setup agent)
- Working directory preferences
- Max iterations —
0means unlimited (recommended for long autonomous tasks; abort with Ctrl+C or daemon/stop) - Cost mode and related caps
- Auto-compact stays on by default (see Agent engine)
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 --showDaemon without the wizard:
# Edit ~/.xibecode/daemon.env (or gateway.env)
TELEGRAM_BOT_TOKEN=...
TELEGRAM_ALLOWED_USERS=your_user_id
ANTHROPIC_API_KEY=... # or provider-specific key
xibecode daemon --install --workdir /path/to/repo
xibecode daemon --start
# alias: xibecode gateway --install / --startRelated
| Command | Purpose |
|---|---|
xibecode config | Interactive or flag-based profile edits |
Chat /setup | In-session provider/key/model (chat TUI only) |
xibecode diagnostics | Redacted diagnostics bundle |
xibecode update --check | Check for newer npm CLI (never silent apply) |
Note: CLI xibecode setup is the full onboarding path. Chat slash /setup only updates the active chat profile for that session.