Skip to content

Configuration

User settings, environment variables, and model catalog configuration.

Updated View as Markdown

Configuration

Fusion stores its configuration, session history, and cached skills under ~/.fusion (or $FUSION_HOME).

User Config File

Create or edit your user configuration file at ~/.fusion/config.toml:

mkdir -p ~/.fusion
$EDITOR ~/.fusion/config.toml

Example config.toml

# Default model selection (defaults to Cloudflare Workers AI model)
model = "cloudflare-kimi-k2.7"

[ui]
# Prefer phone-friendly scrollback UI by default
screen_mode = "minimal"

[providers.cloudflare]
account_id = "YOUR_CLOUDFLARE_ACCOUNT_ID"
api_token = "YOUR_CLOUDFLARE_API_TOKEN"

[providers.xai]
api_key = "YOUR_XAI_API_KEY"

[providers.openai]
api_key = "YOUR_OPENAI_API_KEY"
base_url = "https://api.openai.com/v1"

Environment Variables

You can configure provider keys and paths using standard environment variables:

Variable Description
FUSION_HOME Override root config directory (default: ~/.fusion)
CLOUDFLARE_ACCOUNT_ID Cloudflare Workers AI Account ID
CLOUDFLARE_API_TOKEN Cloudflare Workers AI API Token
XAI_API_KEY xAI API key
OPENAI_API_KEY OpenAI-compatible API key
PROTOC Custom path to protoc compiler when building from source

Model Catalog & Providers

Fusion includes out-of-the-box support for multiple providers and OpenAI-compatible gateways:

  • Fusion AI Gateway: MiniMaxAI/MiniMax-M2.7, moonshotai/Kimi-K2.6, fusion-auto (Auth via fc_ key. See API Keys)
  • Cloudflare Workers AI: cloudflare-kimi-k2.7, cloudflare-llama-3.3-70b
  • xAI: grok-beta, grok-2
  • OpenAI Compatible / OpenCode: See OpenCode Integration

Switch models on the fly using CLI flags or interactive slash commands:

# Switch model via CLI flag
fusion -m cloudflare-kimi-k2.7

# Switch model inside TUI
/model cloudflare-kimi-k2.7
Navigation

Type to search…

↑↓ navigate↵ selectEsc close