General Settings

Open Settings → General to configure app-wide preferences that affect how Tarsk looks and runs.

Font Size

Adjust the Font size slider to scale text across the app. On mobile viewports, Tarsk applies an additional multiplier so text remains readable on smaller screens. Click Reset to restore the default size.

Appearance

Choose your color scheme: Light, Dark, or System (follows your OS setting).

Maximum Turn Count

Set the Maximum turn count to limit how many agent tool-call rounds a single response can use. This helps control runaway loops on complex tasks. Leave at the default for most work; lower it when you want tighter control over agent autonomy.

AI Voice Cleanup

Toggle AI Voice Cleanup to run voice transcriptions through AI after you stop recording. When enabled, the AI removes filler words, false starts, and repetitions from the raw transcription before inserting it into the chat input.

Voice Model

Choose the speech recognition model used by the microphone button in chat:

Option	Description
Standard	Default Whisper model (~75 MB download on first use)
Tiny	Smaller, faster model with slightly lower accuracy

The model is downloaded once and cached locally. Speech recognition runs entirely in your browser via WebAssembly — no audio is sent to external servers.

Server Bind Mode

Controls which network interfaces the Tarsk API server listens on:

Mode	Behaviour
Local	Server accepts connections from localhost only (default)
Network	Server accepts connections from other devices on your LAN

When Network mode is enabled, Tarsk displays the URLs you can use from a phone, tablet, or another computer (e.g. http://192.168.1.42:641) and a QR code for the Tarsk mobile app.

Using Tarsk on Mobile

1. Run Tarsk on your desktop with Network bind mode enabled.
2. On your phone or tablet, download the Tarsk app from the App Store, scan the QR Code, or enter the IP Address manually.
3. If the app cannot reach the server (e.g. after a restart), the Connect to Tarsk dialog lets you enter the server URL manually.

The responsive web UI adapts to mobile screens — collapsible sidebar, scrollable tabs, and adjusted font scaling. See Installation for CLI --server mode if you want a headless server without opening a browser.

For the native mobile app with QR code scanning, see the Mobile App guide.

Daily Spend

Toggle Daily Spend to show an estimated cost counter in the main tab bar. The widget displays today’s spend and refreshes when agent responses complete.

Hover the widget to see a tooltip with today’s spend, last 30 days total, and average daily spend. Click the widget to open a detailed dialog that also shows token counts (input/output) and tool output compression savings.

Toggle this off if you prefer a cleaner toolbar.

Screen & System Audio Recording (macOS)

On macOS, Tarsk needs Screen & System Audio Recording permission to capture screen content for browser tools and screen sharing features. The General settings page shows the current permission status and provides a button to open System Settings directly.

If permission is denied, grant it in System Settings > Privacy & Security > Screen & System Audio Recording.

Logging

Toggle Logging to send application logs to Better Stack for remote monitoring and debugging. This requires two environment variables set before starting Tarsk:

• BETTERSTACK_SOURCE_TOKEN
• BETTERSTACK_INGESTING_HOST

Restart Tarsk after configuring these variables.

Related

• Mobile App — native iOS and Android app, QR code connection
• Installation — CLI flags including --server
• Account — prompt balance and billing
• Chat — speech input in the chat interface