Configuration /config

API Keys

muxd supports 9 LLM providers. Set API keys via environment variables or /config:

/config set anthropic.api_key sk-ant-...
/config set openai.api_key sk-...
/config set mistral.api_key ...
/config set grok.api_key xai-...
/config set zai.api_key ...
/config set google.api_key ...
/config set fireworks.api_key ...
/config set deepinfra.api_key ...
/config set ollama.url http://localhost:11434
/config set brave.api_key BSA...

Or use environment variables:

export ANTHROPIC_API_KEY="sk-ant-..."
export OPENAI_API_KEY="sk-..."
export MISTRAL_API_KEY="..."
export GROK_API_KEY="xai-..."
export ZAI_API_KEY="..."
export GOOGLE_API_KEY="..."
export FIREWORKS_API_KEY="..."
export DEEPINFRA_API_KEY="..."
export OLLAMA_URL="http://localhost:11434"

Resolution order: environment variable > /config set preference.

Config file

All preferences are stored in ~/.config/muxd/config.json. You can edit this file directly or use /config set from the TUI. Here's a sample:

{
  "model": "claude-sonnet",
  "anthropic_api_key": "sk-ant-...",
  "brave_api_key": "BSA...",
  "daemon_bind_address": "0.0.0.0",
  "hub_url": "http://192.168.1.50:4097",
  "hub_node_token": "your-hub-token",
  "hub_node_name": "my-desktop"
}

Only set the keys you need — omitted keys use defaults. The file is created automatically on first run.

/config Subcommands

/config set Keys

Provider Keys

Model

Footer Display

Preset emoji names: devil, imp, fire, rocket, skull, robot, ghost, alien, bolt, star, diamond, snake, cat, dog, heart. Use none to remove.

/config set footer.emoji devil
/config set footer.emoji none

Or use the interactive picker: /emoji

Hub

Settings for running a hub coordinator (muxd --hub).

Node (Client)

Settings for registering a daemon as a node with an existing hub.

See the Hub setup guide for the full connection flow.

SMS (Textbelt)

/config set textbelt.api_key your-api-key

Get an API key at textbelt.com. Enables the sms_send, sms_status, and sms_schedule tools.

Daemon

Use 0.0.0.0 to make muxd accessible from other devices on your LAN (e.g. the muxd mobile app):

/config set daemon.bind_address 0.0.0.0

Or pass it as a CLI flag:

muxd -bind 0.0.0.0
muxd --daemon -bind 0.0.0.0

Scheduler

Note: Scheduled agent tasks (created via schedule_task or /schedule add-task) bypass the scheduler.allowed_tools allowlist. The spawned agent enforces its own tool policy at runtime.

Tools

Boolean values accept: true/false, on/off, yes/no, 1/0 (case-insensitive).

Model Aliases

Use short aliases instead of full model IDs:

The anthropic/ prefix is optional: anthropic/claude-sonnet and claude-sonnet are equivalent.

/config set model claude-opus

Provider Prefixes

Use provider/model syntax to specify a model from any provider:

Auto-Detection

When no prefix is given, muxd detects the provider from the model name:

Provider Model Examples

/config set model claude-sonnet          # Anthropic (alias)
/config set model gpt-4o                 # OpenAI (auto-detected)
/config set model mistral-large-latest   # Mistral (auto-detected)
/config set model grok-3                 # Grok / xAI (auto-detected)
/config set model glm-4                  # Z.AI (auto-detected)
/config set model fireworks/llama-v3p1-70b           # Fireworks (prefix)
/config set model deepinfra/meta-llama/Meta-Llama-3.1-70B-Instruct  # DeepInfra (prefix)
/config set model google/gemini-2.0-flash            # Google (prefix)
/config set model llama3.3:latest        # Ollama (auto-detected by ":")

Pricing

muxd tracks estimated costs per session.

Built-in pricing

Custom pricing

Override or add pricing in ~/.config/muxd/pricing.json:

{
  "my-custom-model": {
    "input": 1.0,
    "output": 5.0
  }
}

Values are dollars per million tokens. Custom entries merge with defaults.

Data Directory