Configuration Reference

All configuration lives in ~/.reeboot/config.json. Every field is optional — reeboot uses safe defaults when fields are absent.

This reference is derived directly from reeboot/src/config.ts (the Zod schema). Field names, types, and defaults are authoritative.

agent

Top-level agent settings.

agent.model

LLM provider and credential configuration.

Example — own credentials:

{
  "agent": {
    "name": "Reeboot",
    "model": {
      "authMode": "own",
      "provider": "anthropic",
      "id": "claude-sonnet-4-5",
      "apiKey": "sk-ant-..."
    }
  }
}

Example — reuse pi credentials:

{
  "agent": {
    "model": {
      "authMode": "pi"
    }
  }
}

channels

channels.web — WebChat

channels.whatsapp — WhatsApp

channels.signal — Signal

sandbox

Controls OS-level sandboxing for bash tool execution.

To disable sandboxing entirely, set extensions.core.sandbox: false. See Sandbox.

server

HTTP server settings.

credentialProxy

An optional credential proxy server that can broker API key access for clients that cannot store secrets directly.

logging

Structured logging via pino. Logs are written to stdout (NDJSON) and to ~/.reeboot/logs/.

→ See Logging for CLI commands and the live SSE stream.

search

Web search backend for the web_search agent tool.

Alternatively, set provider-specific env vars: BRAVE_API_KEY, TAVILY_API_KEY, SERPER_API_KEY, EXA_API_KEY.

The fetch_url tool is always available regardless of search.provider.

→ See Web Search for full provider details.

heartbeat

System heartbeat fires on a schedule and dispatches a prompt to the agent. If the agent has nothing to do, it responds IDLE (silently suppressed).

→ See Proactive Agent.

session

routing

Controls which context handles messages from which channel or peer.

Example:

{
  "routing": {
    "default": "main",
    "rules": [
      { "channel": "whatsapp", "context": "personal" },
      { "peer": "+15559999999", "context": "work" }
    ]
  }
}

memory

Personal memory persists facts, preferences, and corrections across sessions. Memory is on by default.

The session_search tool (full-text search over past conversations) is always available regardless of memory.enabled.

→ See Personal Memory.

knowledge

Domain knowledge enables the agent to ingest and search your local documents using vector embeddings.

→ See Domain Knowledge.

budget

Token and cost limits. All limits are per-context per-day/session/turn — not instance-wide.

Cost is tracked via pi’s built-in ModelRegistry. For local/Ollama models, cost is unavailable (displayed as “cost unavailable”, not $0.00).

→ See Token Budget.

resilience

Controls how reeboot handles provider outages, crashed turns, and missed scheduled tasks.

→ See Resilience.

extensions

extensions.core

Toggle built-in extensions. All default to true (enabled).

mcp

MCP (Model Context Protocol) tool servers accessed via the mcp proxy tool.

mcp.servers[]

Each entry in the servers array defines one MCP server:

Example:

{
  "mcp": {
    "servers": [
      {
        "name": "filesystem",
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"],
        "env": {},
        "permissions": { "network": false, "filesystem": true }
      }
    ]
  }
}

→ See MCP Tools.

security

security.injection_guard

permissions

permissions.violations

skills

contexts[]

Define named contexts for multi-thread conversations.

Example:

{
  "contexts": [
    { "name": "work", "tools": { "whitelist": ["web_search", "fetch_url"] } },
    { "name": "personal" }
  ]
}

Complete Annotated Example

{
  "agent": {
    "name": "Reeboot",
    "turnTimeout": 300000,
    "model": {
      "authMode": "own",
      "provider": "anthropic",
      "id": "claude-sonnet-4-5",
      "apiKey": "sk-ant-..."
    }
  },
  "channels": {
    "web": { "enabled": true, "port": 3000 },
    "whatsapp": {
      "enabled": true,
      "owner_id": "+15551234567",
      "owner_only": true,
      "trust": "owner"
    },
    "signal": {
      "enabled": false,
      "phoneNumber": "+15559876543",
      "apiPort": 8080
    }
  },
  "search": { "provider": "duckduckgo" },
  "memory": {
    "enabled": true,
    "memoryCharLimit": 2200,
    "userCharLimit": 1375,
    "consolidation": { "enabled": true, "schedule": "0 2 * * *" }
  },
  "knowledge": {
    "enabled": false,
    "wiki": { "enabled": false }
  },
  "budget": {
    "daily_tokens": null,
    "daily_cost_usd": 2.00,
    "session_tokens": 100000,
    "session_cost_usd": null,
    "turn_tokens": 20000,
    "turn_cost_usd": null,
    "warn_threshold": 0.8
  },
  "heartbeat": {
    "enabled": true,
    "interval": "every 30m",
    "contextId": "main"
  },
  "resilience": {
    "recovery": { "mode": "safe_only" },
    "outage_threshold": 3,
    "probe_interval": "1h",
    "scheduler": { "catchup_window": "1h" }
  },
  "logging": { "level": "info", "retention_days": 30 },
  "sandbox": { "mode": "os" },
  "mcp": {
    "servers": [
      {
        "name": "filesystem",
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/documents"],
        "env": {},
        "permissions": { "network": false, "filesystem": true }
      }
    ]
  },
  "skills": {
    "permanent": [],
    "ephemeral_ttl_minutes": 60
  },
  "routing": {
    "default": "main"
  },
  "session": {
    "inactivityTimeout": 14400000
  }
}