Settings

App-level settings document version 1 (

signoff:app-settings:v1

On Windows, the full Settings overlay covers General through About. On VS Code, use in-webview Preferences / AI surfaces; there is no

contributes.configuration

Starter workflows: Quick Start.

General

• Platform Availability: Windows Settings overlay full; shared defaults apply to both hosts’ HTTP pipeline
• Overview: Transport defaults for HTTP version, timeouts, SSL, cookies, redirects, validation, and response formatting. Request-level Settings can still override selected behaviors.
• How It Works (Windows App):
  1. Open Settings (gear / Ctrl+, / Help).
  2. Select General; edit fields; close — changes persist immediately.
  3. Send a request to verify timeout/SSL/cookie behavior.

• How It Works (VS Code Extension):
  1. Prefer request Settings tab for per-request overrides.
  2. Shared app settings apply when the host loads the same settings store.
  3. OS/VS Code proxy may still apply outside Signoff’s manual proxy mode.

• Code / Configuration Examples:

{
  "general": {
    "httpVersion": "auto",
    "timeoutMs": 30000,
    "maxResponseMb": 50,
    "sslVerification": true,
    "sslDebug": false,
    "sendCookies": true,
    "storeCookies": true,
    "validateRequests": true,
    "followRedirects": true,
    "responseFormat": "auto"
  }
}

httpVersion

auto

http1

auto

timeoutMs

30000

maxResponseMb

50

sslVerification

true

sslDebug

false

sendCookies

storeCookies

true

validateRequests

true

followRedirects

true

responseFormat

auto

json

text

auto

• Edge Cases, Troubleshooting & Pro-Tips:
  • Turn on

    sslDebug

    only while diagnosing MITM/proxy appliances.
  • Huge payloads: raise

    maxResponseMb

    carefully — memory is local.

GAP IDENTIFIED: Full General section UI lives in the Windows Settings overlay. VS Code has no Marketplace settings keys for these fields.

Appearance

• Platform Availability: Full Parity (Preferences / Appearance). Theme packs also on Windows overlay.
• Overview: Theme, density, editor font size/family, and UI zoom. VS Code additionally bridges host theme tokens into the webview.
• How It Works (Windows App):
  1. Help → Appearance, utility palette, or Settings → Appearance.
  2. Pick theme (Be Creative, Signoff Studio, VS Code Dark, Light/Dark/High contrast packs, etc.).
  3. Adjust density (

     comfortable

     /

     compact

     ), font size (10–28), zoom (0.5–2).

• How It Works (VS Code Extension):
  1. Open Appearance / Preferences from the utility bar.
  2. Host theme bridge keeps webview close to the IDE chrome.
  3. Editor font family empty → product default stack.

• Code / Configuration Examples:

{
  "appearance": {
    "theme": "beCreative",
    "density": "comfortable",
    "editorFontSize": 13,
    "editorFontFamily": "",
    "uiZoom": 1
  }
}

• Edge Cases, Troubleshooting & Pro-Tips:
  • Extreme zoom can clip dense Runner tables — reset

    uiZoom

    to

    1

    .
  • High contrast themes help assert failure scanning in Runner.

Shortcuts

• Platform Availability: Full Parity for default keymap; override editor on Windows Settings → Shortcuts
• Overview: Default chords for send/save/duplicate/tabs/settings. Overrides map action id → chord; VS Code does not contribute keybindings — host chords may take precedence.
• How It Works (Windows App):
  1. Settings → Shortcuts.
  2. Review defaults; set overrides as needed.
  3. See Shortcuts for Runner/DB tables.

• How It Works (VS Code Extension):
  1. In-webview shortcuts match the shared keymap when focus is in the webview.
  2. Bind

     qasignoff.*

     commands yourself in

     keybindings.json

     .
  3. Avoid colliding with Chord-heavy VS Code defaults (e.g. Ctrl+K).

• Code / Configuration Examples:

{
  "shortcuts": {
    "overrides": {
      "sendRequest": { "ctrl": true, "key": "Enter" }
    }
  }
}

Default action ids include:

sendRequest

save

duplicate

explorerRename

explorerDelete

explorerMove

openSettings

closeTab

reopenTab

• Edge Cases, Troubleshooting & Pro-Tips:
  • Empty overrides

    {}

    restores defaults.
  • Full chord tables: shortcuts.md.

AI

• Platform Availability: Capability Full Parity; Windows overlay is the richest token UI
• Overview: BYOK providers, privacy flags, autocomplete mode, timeouts. See AI assist.
• How It Works (Windows App): Settings → AI → enable provider → set token → test → use assist bar.
• How It Works (VS Code Extension): Configure via webview AI settings; no

  settings.json

  contribution.

• Code / Configuration Examples:

{
  "ai": {
    "enabled": true,
    "defaultProvider": "none",
    "defaultModel": "",
    "autocompleteModel": "",
    "timeoutMs": 60000,
    "maxTokens": 2048,
    "sendMethodAndPath": true,
    "sendHeaders": false,
    "sendBody": false,
    "sendResponseBody": false,
    "includeSchema": false,
    "autocomplete": "debounced",
    "providers": {
      "openai": { "enabled": false, "model": "", "hasToken": false },
      "anthropic": { "enabled": false, "model": "", "hasToken": false },
      "azure": {
        "enabled": false,
        "endpoint": "",
        "deployment": "",
        "apiVersion": "2024-02-15-preview",
        "hasToken": false
      },
      "gemini": { "enabled": false, "model": "", "hasToken": false },
      "openaiCompat": {
        "enabled": false,
        "name": "Local OpenAI-compatible",
        "baseUrl": "http://127.0.0.1:11434/v1",
        "model": "",
        "hasToken": false
      }
    }
  }
}

Providers enum:

none

openai

anthropic

azure

gemini

openai-compat

off

debounced

aggressive

manual

• Edge Cases, Troubleshooting & Pro-Tips:
  • Tokens are host-secret storage — exports only show

    hasToken

    .
  • Keep headers/bodies off unless the provider account is trusted.

GAP IDENTIFIED: Desktop Settings overlay AI forms (set/clear token, test connection, list models) are Windows-first.

Proxy

• Platform Availability: Windows Settings overlay; Partial on VS Code (OS/IDE proxy)
• Overview: Modes

  none

  ,

  system

  ,

  manual

  with host/port/username/password presence and bypass list.
• How It Works (Windows App): Settings → Proxy → choose mode → for manual, set host/port/auth → bypass

  localhost,127.0.0.1,<local>

  .
• How It Works (VS Code Extension): Rely on OS / VS Code proxy settings; Signoff manual proxy UI may be unavailable.

• Code / Configuration Examples:

{
  "proxy": {
    "mode": "none",
    "host": "",
    "port": 8080,
    "username": "",
    "hasPassword": false,
    "bypass": "localhost,127.0.0.1,<local>"
  }
}

• Edge Cases, Troubleshooting & Pro-Tips:
  • Corporate SSL inspection: add enterprise CA under Certificates and/or disable verification only temporarily.
  • WebSocket/MQTT often fail through intercepting proxies — test direct.

GAP IDENTIFIED: Full proxy editor is on the Windows Settings overlay.

Certificates

• Platform Availability: Windows Settings overlay; Partial elsewhere
• Overview: Client and CA certificates (paths to cert/key/PFX) with optional passphrase presence flags. Enable/disable per entry.
• How It Works (Windows App): Settings → Certificates → add client/CA → point at files → enable.
• How It Works (VS Code Extension): Use OS trust store / request-level options when overlay is unavailable.

• Code / Configuration Examples:

{
  "certificates": [
    {
      "id": "cert_client_1",
      "name": "Corp client",
      "kind": "client",
      "certPath": "C:/certs/client.crt",
      "keyPath": "C:/certs/client.key",
      "pfxPath": "",
      "enabled": true,
      "hasPassphrase": true
    }
  ]
}

• Edge Cases, Troubleshooting & Pro-Tips:
  • Passphrases are not in the settings JSON — only

    hasPassphrase

    .
  • Wrong kind (

    client

    vs

    ca

    ) is a common mTLS failure mode.

GAP IDENTIFIED: Certificate manager UI is Windows Settings overlay.

Updates

• Platform Availability: Windows Only (auto-check). VS Code uses Marketplace updates.
• Overview:

  autoCheck

  toggles desktop update polling / banner behavior.
• How It Works (Windows App): Settings → Updates → enable auto-check; apply banners when offered.
• How It Works (VS Code Extension): Marketplace updates the extension automatically (sideloaded VSIX does not).

• Code / Configuration Examples:

{
  "updates": {
    "autoCheck": true
  }
}

• Edge Cases, Troubleshooting & Pro-Tips:
  • Air-gapped desktops: disable auto-check and install offline builds intentionally.
  • Confirm versions: Windows Help → About; VS Code Extensions detail.

GAP IDENTIFIED: Desktop update banner is Windows Only.

Security

• Platform Availability: Windows overlay + shared export behavior
• Overview: Mask secrets in UI and control whether exports include secret values.
• How It Works (Windows App): Settings → Security → keep Never show secrets on; leave Include secrets in export off unless you have a secure channel.
• How It Works (VS Code Extension): Same flags when exposed; always review export dialogs before sharing.

• Code / Configuration Examples:

{
  "security": {
    "neverShowSecrets": true,
    "includeSecretsInExport": false
  }
}

• Edge Cases, Troubleshooting & Pro-Tips:
  • Git commit hooks cannot save you if you exported secrets to a gist — keep

    includeSecretsInExport

    false.
  • MCP tool output also redacts token-like fields.

Console (Preferences)

• Platform Availability: Full Parity
• Overview: Utility Console behavior + anonymous product ping. Also edited via bottom Preferences.
• How It Works (Windows App):
  1. Help → Preferences, utility Preferences, or Ctrl+,.
  2. Toggle open-on-error, preserve, compact, help-improve.
  3. Open Console to verify.

• How It Works (VS Code Extension): Same Preferences + Console in the webview.

• Code / Configuration Examples:

{
  "console": {
    "autoOpenOnError": true,
    "preserve": true,
    "compact": false,
    "helpImproveProduct": true
  }
}

autoOpenOnError

preserve

compact

helpImproveProduct

• Edge Cases, Troubleshooting & Pro-Tips:
  • Ping is optional — turn off if policy requires.
  • Compact mode helps long Runner script traces.

About & related overlay sections

• Platform Availability: Windows Settings overlay (About, Data & Storage, Integrations, Cache, Support)
• Overview: About shows product version. Integrations notes Git lives on the Git tab (no cloud GitHub login on this surface). Data/Cache/Support cover paths and maintenance.
• How It Works (Windows App): Settings → About / Support / Data & Storage / Cache / Integrations.
• How It Works (VS Code Extension): Use Extensions detail for version; workspace paths via Reveal in Explorer.

• Code / Configuration Examples:

Windows app version:  26.8.10
VS Code extension:    0.2.72
Settings storage key: signoff:app-settings:v1

• Edge Cases, Troubleshooting & Pro-Tips:
  • Export/import settings helpers omit raw secrets.
  • Clearing cache does not delete workspace collections on disk.

GAP IDENTIFIED: Entire Settings overlay navigation (Data, Integrations, Cache, Support, About as overlay sections) is Windows Only. VS Code: Preferences + Marketplace extension details.

Next

• Shortcuts
• AI assist
• Troubleshooting
• FAQ
• Parity & gap report