Shortcuts and Appearance

Customizing Your Workflow

Witsy is designed to stay out of your way until you need it. By configuring global shortcuts and tailoring the interface, you can transform it from a simple chat app into a seamless part of your OS.

Setting Up Global Hotkeys

To interact with Witsy without switching windows manually, you can define a global shortcut to toggle the assistant's visibility.

Open Settings (⌘+,).
Navigate to the General tab.
Click on the Global Shortcut input field.
Type your desired key combination (e.g., Option + Space or Shift + Cmd + A).

Tip: Use a shortcut that doesn't conflict with system defaults like Spotlight or Raycast to ensure Witsy responds instantly from any application.

UI Appearance and Themes

Witsy supports multiple visual modes to match your environment.

Switching Themes

You can toggle between Light, Dark, or System themes:

System (Default): Witsy follows your macOS or Windows color scheme automatically.
Dark Mode: Ideal for late-night coding sessions or reducing eye strain.

Managing WebApps in the Interface

Witsy allows you to run external AI web interfaces (like ChatGPT or Claude) inside its own windows via the WebApp Viewer.

Toggle Visibility: You can enable or disable specific WebApps in the sidebar via the WebApps section in Settings.
Last Used Sorting: Witsy automatically tracks which WebApps you use most frequently to keep your workspace organized.

Advanced Webview Customization

Because Witsy uses an embedded webview for many features, you can customize how these "mini-browsers" behave to ensure privacy and compatibility.

Recipe: "Stealth" User-Agent

Some web services block "Electron" or "Assistant" apps. Witsy automatically cleans your User-Agent string to look like a standard browser.

Why use this? To prevent sites from blocking the WebApp Viewer or showing "Unsupported Browser" warnings.
How it works: Witsy strips identification strings like Witsy and Electron from the request headers before they reach the server.

Recipe: Controlling Link Behavior

You can decide whether links clicked inside a Witsy Webview should stay inside the app or open in your default browser.

Internal Navigation: Useful for staying focused within a documentation site.
External Browsing: Set links to open in Chrome/Safari/Arc to keep your Witsy window dedicated to the AI task at hand.

In-App Navigation Shortcuts

Efficiency doesn't stop at global hotkeys. Use these internal shortcuts to navigate the chat interface:

Spell Check Configuration

If you are using Witsy for drafting professional content or code comments, you can toggle the system spell checker for specific windows.

How-to: In the WebApp Viewer or Chat area, right-click to see spell-check options.
Logic: Witsy integrates with your OS-native dictionaries to provide real-time red underlines for typos without sending your data to third-party grammar services.