Configuration reference

{
  // --- Tunnel (see ../guides/tunnels-and-remote-access.md) ---
  "tunnel": {
    "provider": "none",              // none | ngrok | localtunnel | cloudflare
    "ngrok":      { "auth_token": "…", "domain": "…" },
    "cloudflare": { "tunnel_token": "…", "hostname": "…" }
  },
  "preview_base_url": null,          // override the public base URL for preview links

  // --- Toolchain ---
  "toolchain_mode": "system",        // system | managed

  // --- Workspaces ---
  "default_workspace": "~/…",        // root for new agent sessions
  "workspaces": ["~/dev/app-a"],     // additional registered project folders

  // --- Agents ---
  "default_agent": "claude",
  "enabled_agents": ["claude", "codex"],  // omit to enable every known agent
  "integrations": {
    "mcp_auto_install": true,        // write VibeAround MCP config into agent configs
    "skill_auto_install": true      // write VibeAround skills into agent skill dirs
  },

  // --- Networking ---
  "proxy": { "enabled": true, "http_proxy": "http://…", "no_proxy": "…" },

  // --- Bridge behavior (see ../architecture/local-api-and-bridge.md) ---
  "api_bridge": {
    "replace_provider_web_search": false
  },
  "local_agent_api": { "enabled": true },

  // --- Host-side web search ---
  "search_tool": {
    "enabled": false,
    "max_results": 5,
    "sources": {
      "tavily": { "enabled": true, "api_key": "…" },   // also: brave, exa, grok
      "brave":  { "enabled": false, "api_key_env": "BRAVE_KEY", "base_url": null }
    }
  },

  // --- Per-channel defaults (see ../guides/connect-channels.md) ---
  "remote": {
    "channels": { "telegram": { "agent_id": "claude", "profile_id": "moonshot" } }
  },

  // --- Channel plugin config: passed to plugins verbatim ---
  // Per-channel fields: see guides/channels/. Every channel also accepts
  // an optional verbose object (both flags default to false).
  "channels": {
    "telegram": { "bot_token": "…", "verbose": { "show_thinking": true, "show_tool_use": true } },
    "feishu":   { "app_id": "…", "app_secret": "…" }
  },

  // --- Web terminal ---
  "tmux": { "detach_others": true }
}

{
  "selected_agent": "claude",        // Launch tab's visible agent (UI state)
  "default_agent": "claude",         // VibeAround-wide default: tray quick launch, IM thread creation
  "default_profile_id": "moonshot",  // profile snapshot for that default
  "agents": {
    "codex": {
      "profile_id": "deepseek",      // per-agent default profile
      "workspace": "~/dev/app",      // per-agent default workspace
      "executable": {                 // resolved CLI — written back by va-launch discovery
        "path": "/opt/homebrew/bin/codex",
        "version": "…", "source": "path-scan", "rank": 0
      },
      "launch_args": {
        "terminal": ["--flag-for-your-own-terminal"],  // native launches only
        "acp": ["--flag-for-hosted-spawns"]            // IM/web hosted spawns only
      }
    }
  }
}

{
  "schemaVersion": 1,
  "id": "openai-codex",              // profile name
  "agent": "codex",                  // registry agent id
  "profileId": "openai",             // metadata only — va-launch never reads provider storage
  "launchTarget": "codex",
  "workspace": "/Users/example/project",
  "terminal": "terminal",            // terminal id; see launch internals for the per-OS list
  "command": "codex",                // command line (quote-aware word splitting)
  "executablePath": null,            // explicit CLI override (skips agents.json + PATH)
  "windowsExecutablePath": null,     // Windows app-launch variant
  "windowLabel": "OpenAI Codex",
  "env": { "OPENAI_API_KEY": "…" },  // exported by the generated launch script
  "args": { "native": ["--model", "gpt-5"] },
  "cleanupPaths": [],                // temp files deleted after the command exits
  "macosAppProbe": null,             // app name for the "already running" osascript check
  "windowsProcessProbe": null
}

~/.vibearound/
├── settings.json           # configuration (this page)
├── auth.json               # dashboard token, rewritten each daemon start
├── agents.json             # resolved agent executables (va-launch cache)
├── plugins/<kind>/         # installed channel plugins
├── launch/profiles/        # saved launch profile JSON (schema v1)
├── workspaces/             # default root for created workspaces
├── .cache/                 # channel attachment cache
└── workspace-threads.jsonl # + workspace/attachment event logs