General Settings

Open Settings → Settings (the app-wide preferences page at /settings/general) to configure how Tarsk looks and runs. You can reach it from the gear icon on the projects home screen, ⋯ More options → Settings under General, or the VS Code embed Settings button.

Appearance

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.

Panel Opacity

Adjust Panel opacity to control how frosted panels blend with the wallpaper behind them.

Color Scheme

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

Wallpaper

Choose how the background appears behind the UI:

Mode	Behaviour
Image	Scenic wallpaper image
Background	Solid scenic background
Custom color	Pick a custom background color

Primary Color

Pick a Primary color accent used across the app. Click the color label to reset to the default.

Agent Limits

Maximum Turn Count

Set how many agent tool-call rounds a single response can use before Tarsk asks whether to continue. Lower it when you want tighter control over agent autonomy; leave at the default for most work.

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.

Speech recognition uses a local WebAssembly model (~40 MB download on first use). No audio leaves your machine.

Daily Spend

Toggle Daily Spend to show an estimated cost counter in the chat header. 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, prompt-cache usage, and tool output compression savings.

Screen & Audio Recording (macOS)

On macOS, Tarsk needs Screen & Audio Recording permission to capture screen content for browser tools and screen sharing features. This 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 & Audio Recording.

Sandbox (macOS)

When supported, Sandbox runs bash and skill script execution inside a macOS seatbelt sandbox. This limits what commands can access on your system. The toggle is disabled if the sandbox fails its health check.

You can also toggle sandbox temporarily from the chat mode selector menu.

Logging

Toggle Logging to write verbose application logs to a local file (tarsk-logs.txt in Tarsk’s Application Support directory). Hover the toggle to see the log file path; click the tooltip to copy it.

When BETTERSTACK_SOURCE_TOKEN and BETTERSTACK_INGESTING_HOST are set before starting Tarsk, the same toggle also sends logs to Better Stack. Restart Tarsk after configuring those variables.

--debug also writes to the same file for the current process.

Mobile & Network Access

Controls whether the Tarsk API server accepts LAN connections:

Setting	Behaviour
Off	Server accepts connections from localhost only (default)
On	Server accepts connections from other devices on your Wi-Fi network

When enabled, Tarsk shows the LAN URL (e.g. http://192.168.1.42:641). Restart Tarsk after changing this setting.

Mobile App QR Code

When network access is enabled and a LAN IP is detected, a Mobile App section appears below with a QR code you can scan from the Tarsk mobile app. See Mobile App for connection steps.

Reset Onboarding

Triple-click the Settings item in the settings sidebar to re-run the onboarding wizard.

Related

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