General Settings
The portal's Settings area at xyva.ai/app/settings is the central place to configure language, theme, AI providers, agent sandbox, MCP extensions, proxy and feature flags.

What you'll find here
| Section | Purpose |
|---|---|
| General | Language, theme, brand voice, re-run wizard |
| Account & Devices | Profile, password/OAuth, connected agents |
| AI Providers | BYOK keys per provider, default model |
| Feature Flags | Toggle modules (Test Hub, Swarm, Brain, Device Lab, …) |
| MCP Extensions | Enable curated MCP servers per agent mode |
| Agent Sandbox | Filesystem and shell guardrails for AI workflows |
| Proxy & Network | HTTPS proxy, allowed origins, VPN hints |
| Run History & Storage | Retention, PDF export defaults |
| Billing | Subscription, invoices, license downloads |
| Teams | Members, roles, seat allocation |
Where settings live
- Per-user: language, theme, brand voice — stored on your portal profile.
- Per-agent (machine-local): encrypted credentials in
~/.xyva/credentials.json. - Per-team: feature flags, sandbox policies, MCP whitelist — set by team admins.
You can opt into portable settings to mirror agent-local credentials (encrypted) into the portal so they follow you to a second machine.
Re-running the wizard
Settings → General → Re-run Wizard wipes the per-project Wizard state and reopens it. Use this after a major project restructure or to onboard a new agent.
