# Settings reference A control-by-control reference for every section of the Settings modal. Each heading below is a section on the rail, in the order it appears. ## Account Shows your avatar, name, email, and a plan badge. Two actions sit below the card: Manage account & billing opens your hosted Foxora dashboard in the system browser, and Sign out clears the local session on this device. Plan, usage, and billing are managed on the web — the app shows them read-only. If you’re not signed in, this section invites you to sign in and offers a link to the dashboard. ## Usage & plan Credits cover everything Foxora does, drawn down against rolling weekly and monthly limits. This section shows: - Your current plan and credit balance — used, remaining, and when it resets. - The rolling usage windows, so you can see how close you are to a limit. - Plan cards with monthly credits, marking your current plan. Every money action is a link out to the web dashboard — the app never takes a payment itself. The balance refetches each time you open Settings, so it reflects credits a background run may have spent. ## Appearance Four controls, applied instantly and saved on this device: - Theme — Dark or Light. - Font — the UI typeface (Inter, Geist, DM, or Hanken). - Scheme — the neutral palette, chosen from a row of swatches (taupe, slate, mauve, olive, and more). - Accent — the highlight color, from a second row of swatches. These are the same controls available from the account menu. Full detail in Workspace appearance. ## Voice Talk to your agents and have them talk back. Speech runs through the Foxora gateway, so it’s plan-gated and minute-tracked — if no voice key is configured on the gateway yet, the section shows a short note and turns on automatically once it’s available. When voice is on you can set: - Enable voice — the master switch for voice input and spoken replies. - Voice — pick the voice your agent speaks in. - Speak replies aloud and a Speed control (0.75× to 1.5×). - Input mode — Push to talk or Hands-free, with a Send right away option for push-to-talk and Noise suppression. - Wake phrase — e.g. “Hey Foxora”; leave blank to disable hands-free wake. More in Voice. ## Models Your default models, always on. Foxora routes each step to the cheapest tier that can do the job, and every call goes through the gateway — no provider keys touch the app. Three tiers are listed, each marked Included or Locked depending on your plan: - Fast — snappy, low-latency models for everyday tasks. - Premium — deeper reasoning for complex, multi-step work. - Max — the most capable models for your hardest work (Max plan). Below the tiers, a Gateway card shows the routed endpoint. Further down, Your providers lets you bring your own API keys (OpenAI, Anthropic, and others) so the gateway can route through your own provider accounts — your usage, your rates. The managed gateway stays the default for every agent. See Models & tiers. > Tiers, not model namesFoxora names the tier, not the vendor — the underlying models change, and routing is the whole point. You pick how much horsepower a step gets; Foxora picks the model. ## Connections The apps your agents can act in — GitHub, Linear, Notion, and the rest of the connector catalog. Connect a service, and its tools become available to your agents per turn. Manage which are linked, browse the catalog to add more, and disconnect any you no longer want. Full detail in Connections. ## Channels Deploy your crew where the business talks. Connect a platform — team chat, customer messaging, email, voice, or web — then route it to an agent. Channels run on Foxora’s hosted side, so they keep working when the desktop app is closed. Connect Slack, Gmail, Discord, or Telegram to reach your agents there. See Channels. ## MCP Server Use Foxora’s tools inside other apps by adding Foxora as an MCP server in Claude Desktop, Cursor, or any MCP client. The section gives you a ready-to-paste JSON configuration block pointing at the engine’s /mcp endpoint, and lists the exposed tools — read-only and web only (file reading, listing, search, and web fetch). Shell and file-writing tools are deliberately not exposed. See Foxora as an MCP server. ## Permissions The OS capabilities your agents may use — granted only when a task needs them, and changeable here anytime. Capabilities are grouped, and each row shows a status and the right action: - Web-grantable capabilities (microphone, camera, notifications) show a live status dot and an Allow button that triggers the browser prompt; once granted they read Allowed. - OS-managed capabilities (screen recording, accessibility, automation, full-disk access) can’t be prompted — an Open Settings button deep-links you straight to the exact system pane. - Capabilities that don’t apply to your current OS read No setup needed. More in Permissions. ## Data Back up or move your local data — agents, crews, roles, skills, schedules, preferences, and more. Each category has a switch (all on by default). Then: - Export selected downloads a JSON bundle of the chosen categories. - Import from file… restores from a bundle, merging into what’s already here — it never wipes existing data. Everything stays on this device; only the file you download leaves it. See Where your data lives. ## Advanced Connection status and local data, in three cards: ### Connection probes A live status row for each endpoint — Engine (cloud), Login, and Gateway — showing the URL plus a dot reading Connected, Unreachable, or Checking…. Services probe their health endpoint; the login page is probed for plain reachability. ### Foxora data folder Everything Foxora keeps on this device — the engine, Memory Den, and your workspace files — lives in ~/.foxora (%USERPROFILE%\.foxora on Windows). A Reveal in Finder / Explorer button opens it. (This card appears only inside the desktop app.) ### Reset local preferences Clears theme, scheme, accent, and font on this device, then reloads. Your account and sessions are untouched. A confirm step guards the reset. > Reset is localResetting preferences clears local choices only. It does not touch your account, your server-side sessions, or your billing. ## Keyboard A reference of every keyboard shortcut, grouped by category, with OS-aware key labels (⌘ on macOS, Ctrl elsewhere). This view is a cheat sheet — the shortcuts themselves work throughout the app. ## About The Foxora mark, the product name, and the running version — the app version when available, otherwise the UI build. A one-line tagline rounds it out: Your operating system for AI agents.