Workjet
Back to Workjet

Configuration

Workjet is designed to work out of the box, but you can customize the gateway connection, API keys, appearance, and keyboard shortcuts to match your workflow.

Gateway URL

The gateway URL tells Workjet where to send AI requests. By default, Workjet connects to the managed gateway at https://api.workjet.dev. If your organization runs a self-hosted gateway, update this in Settings.

  1. Open Settings from the sidebar (gear icon)
  2. Navigate to the Gateway section
  3. Enter your gateway URL (e.g., https://gateway.yourcompany.com)
  4. Click Save

The gateway URL can also be configured by your organization admin via the Portal. Admin-configured URLs take precedence over local settings.

API Key Management

API keys authenticate the desktop app against the gateway. Keys follow the format wj_live_... and are hashed with SHA-256 before storage — the raw key is shown once at creation and never stored.

Creating an API Key

  1. Sign in to portal.workjet.dev
  2. Go to Settings > API Keys
  3. Click Create Key
  4. Copy the key immediately — it will not be shown again
  5. Paste the key into the desktop app's Settings panel

Important: API keys are shown only once at creation. Store the key in a secure location. If you lose it, you'll need to create a new one.

Using an API Key

In the desktop app, open Settings and enter your API key in the API Key field. The app validates the key against the gateway and displays a green checkmark on success.

For programmatic access, include the key in the Authorization header: 

Authorization: Bearer wj_live_abc123...

See the Authentication reference for full details.

Theme Settings

Workjet uses a Tokyo Night-inspired dark theme by default. The theme is defined via CSS custom properties, making it easy to customize.

Current theme options:

  • Dark (default): Tokyo Night color palette with navy backgrounds and teal accents
  • High contrast: Enhanced contrast ratios for accessibility compliance

Theme preferences are stored in localStorage and applied immediately without requiring a restart.

Zoom Controls

Adjust the UI zoom level between 50% and 200% to match your display preferences.

Action Shortcut
Zoom in Ctrl + = (or Cmd + = on macOS)
Zoom out Ctrl + - (or Cmd + - on macOS)
Reset zoom Ctrl + 0 (or Cmd + 0 on macOS)

The current zoom level is displayed in the status bar at the bottom of the window.

Keyboard Shortcuts

Action Windows / Linux macOS
New tab Ctrl + T Cmd + T
Close tab Ctrl + W Cmd + W
Next tab Ctrl + Tab Ctrl + Tab
Previous tab Ctrl + Shift + Tab Ctrl + Shift + Tab
Toggle sidebar Ctrl + B Cmd + B
Focus chat Ctrl + L Cmd + L
Send message Enter Enter
New line in chat Shift + Enter Shift + Enter
Zoom in Ctrl + = Cmd + =
Zoom out Ctrl + - Cmd + -
Reset zoom Ctrl + 0 Cmd + 0

Local Storage

Workjet stores data locally for offline access and privacy:

  • Credentials: Stored in the OS keychain (macOS Keychain, Windows Credential Manager, Linux Secret Service)
  • Conversation history: Stored on the local filesystem
  • Settings: Stored in localStorage
  • MCP connections: Stored locally with encrypted environment variables

Next Steps