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 account menu in the sidebar footer, or the VS Code embed Settings button.
Appearance
Section titled “Appearance”Font Size
Section titled “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.
Panel Opacity
Section titled “Panel Opacity”Adjust Panel opacity to control how frosted panels blend with the wallpaper behind them.
Color Scheme
Section titled “Color Scheme”Choose Light, Dark, or System (follows your OS setting).
Wallpaper
Section titled “Wallpaper”Choose how the background appears behind the UI:
| Mode | Behaviour |
|---|---|
| Image | Scenic wallpaper image |
| Background | Theme background |
| Custom color | Pick a custom background color |
Primary Color
Section titled “Primary Color”Pick a Primary color accent used across the app. Click the color label to reset to the default.
Agent Limits
Section titled “Agent Limits”Maximum Turn Count
Section titled “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
Section titled “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.
Toggle 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)
Section titled “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.
Confirm Commands
Section titled “Confirm Commands”Toggle Confirm Commands to require approval before the agent runs bash commands, skill scripts, and browser shell calls. When off (default), commands run without per-command prompts.
When confirm commands is enabled, allowed command patterns listed on the same page (and patterns you save from approval prompts) run automatically without prompting. See Permissions.
Sandbox (macOS)
Section titled “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
Section titled “Logging”Toggle Logging to raise application log verbosity. Recent entries appear in Settings → Logs; Tarsk no longer writes a log file. Agent runs are stored in the local database, not in a log.
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. Tarsk only posts to Better Stack ingest hosts on its allowlist — in.logs.betterstack.com, or a *.betterstack.com / *.betterstackdata.com host, optionally with a port. Any other value leaves Better Stack logging off.
--debug raises log verbosity for the current process.
Mobile & Network Access
Section titled “Mobile & Network Access”Turn this on to reach Tarsk from a phone or another computer. You must be signed in. Tarsk opens a public address on tarsk.net.
| Setting | Behaviour |
|---|---|
| Off | Use the runtime’s default bind address (default) |
| On | Open a public address |
When it is on, Tarsk shows a public address (https://<id>.tarsk.net). Tarsk keeps the same id for this computer.
Restart Tarsk after changing this setting. Anyone who opens the public address must sign in as the same account. The address stops working when you turn this off and restart.
Do not use Off as a security boundary. Tarsk leaves the bind hostname unset in this mode. Use your firewall to restrict access.
Mobile App QR Code
Section titled “Mobile App QR Code”When network access is on, a Mobile App section appears with a QR code for the public address. See Mobile App for connection steps.
Reset Onboarding
Section titled “Reset Onboarding”Triple-click the Settings item in the settings sidebar to re-run the onboarding wizard.
Related
Section titled “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