Skip to content

Settings ​

The Settings page uses a left nav + content area layout. After changing options, click Save Settings in the top-right corner to persist changes locally.

Settings Tabs ​

TabDescription
GeneralTheme, log level, body/WebSocket capture limits, workspace paths
ProxyListen port, bind address, upstream proxy
BrowserDefault browser, custom path, incognito, CDP debug port
CertificateCA path, export/regenerate, GM SPKI display
AboutApp version

Where to configure AI

Model, providers, MCP, Engram, and Skills live under AI window → Settings (see AI Features). The main Settings page has no AI tab.

Workspace paths

Under General → Local Workspace, view and open the app data root, config file, database, certificates, reports, and plugin directories.

General ​

OptionDescription
ThemeDark / Light / System / Custom (presets and color tuning)
Log levelInfo or Debug
Max request body captureMB, default 10
Max WebSocket message captureMB, default 1

Proxy ​

OptionDefaultDescription
Proxy port8080Local MITM listen port
Listen address127.0.0.1Bind IP
Upstream proxyemptyOptional, e.g. http://proxy.corp:8080

Domain filtering

Domain exclude rules are configured in the Forwarder filter bar, not in Settings.

Browser ​

OptionDescription
Default browserAuto-detected Chrome / Firefox / Edge, etc.
Custom browser pathOverride executable path
Incognito / private modeAdd privacy launch flags
Auto-clean profile on exitRemove the current project's browser profile before each launch (browser-profile/{projectId}/); other projects are unaffected
Extra launch argse.g. --window-size=1280,720
CDP remote debug portBrowser Agent entry for Chromium, often 9222

Launch Browser in the title bar injects proxy and certificate-related flags automatically.

Certificate ​

ActionDescription
View CA pathGenerated on first proxy start
Export root CAExport for OS/browser trust store
Regenerate CANew key pair; reinstall required
CA key passwordOptional, stored locally
GM SPKI fingerprintSM3 display only; signing algorithm unchanged

Platform install guides are shown on the Certificate tab.

AI configuration ​

These sections map to AI window → Settings navigation (shared local config with main Settings).

Chat Model ​

OptionDescription
Active ProviderProvider used for chat
ModelPick from list or type a custom model name
Max TokensMax tokens per reply
TemperatureSampling temperature 0–2
Tool round limitMax consecutive tool calls per user message
Context window previewClick Re-resolve for current model context limit

Extensions (modals) ​

Click a card to open a modal. Changes apply to the current draft immediately; click Save Settings to persist.

CardContents
ProviderAPI key, base URL, model list, default context tokens
Engram memoryCross-session recall, summaries, enable switch
MCP ServersStdio / HTTP-SSE transport, reconnect status
Dynamic ToolsShell subprocess tools, parameter schema
AI AgentPersonas and system prompts
SkillsSKILL.md packs and tool scope
AdvancedTool permissions, context budget, Ollama /api/show, Python sandbox

MCP example (Stdio) ​

In the MCP Servers modal:

FieldExample
Namefilesystem
TransportStdio
Commandnpx
Args-y, @modelcontextprotocol/server-filesystem, /path/to/dir

Save, then Reconnect in the modal to verify connected servers and tool counts.

Config file ​

Advanced options are stored in the app data directory and maintained when you save settings. Manual editing is not recommended. For bulk deployment or enterprise customization, contact support.

Troubleshooting ​

Settings not applied ​

  1. Confirm Save Settings was clicked
  2. Restart and set log level to Debug under General

Certificate / HTTPS capture issues ​

  1. Install CA into the trusted root store
  2. Re-export after CA regeneration
  3. Firefox uses a separate certificate store

AI connection failures ​

  1. Check API key and base URL under AI window → Settings → Provider
  2. Reconnect MCP servers and verify status
  3. Confirm you clicked Save Settings