Settings Overview
Tarsk settings open as a modal overlay on top of your current view. The chat stays mounted underneath — closing settings (X or Esc) returns you to where you were.
Settings are split into project scope (per repository) and general scope (app-wide). When a project is selected, use the Project | General tabs in the settings header to switch scope and filter the sidebar.
Opening Settings
Section titled “Opening Settings”| Entry point | Opens |
|---|---|
| Gear icon on the projects home screen | General settings (/settings/general) |
| Settings icon in the chat header (when a project is selected) | Project settings for that project |
| ⋯ More options → Settings (Project or General section) | Project or general settings |
| ⋯ More options → Providers or Account | Those settings pages directly |
| VS Code embed Settings button | General settings only |
Project Scope Sidebar
Section titled “Project Scope Sidebar”When Project is selected and a project is active, the sidebar is grouped:
Project
Section titled “Project”| Item | Purpose |
|---|---|
| Settings | Name, setup/validation/run scripts, commit method, confirm commands, built-in browser |
| Instructions | Edit AGENTS.md for the selected branch (requires an active branch) |
| Environment Variables | Encrypted key/value pairs injected into agent shell sessions |
Customize
Section titled “Customize”| Item | Purpose |
|---|---|
| Skills | Install and manage agent skills |
| Rules | Install and manage coding rules |
| Slash Commands | Install and manage / prompt shortcuts |
| Subagents | Install and manage specialized subagents |
| MCP Servers | Configure Model Context Protocol servers |
Advanced
Section titled “Advanced”| Item | Purpose |
|---|---|
| System Prompt | View or customize the generated vs custom project system prompt |
| Model Aliases | Map short names (fast, cheap, smart, etc.) to enabled models |
| Tools | Enable or disable built-in agent tools per project |
See Project Settings for project-level options.
General Scope Sidebar
Section titled “General Scope Sidebar”When General is selected (or no project is active), these items appear:
| Item | Purpose |
|---|---|
| Settings | Font size, appearance, wallpaper, max turn count, voice cleanup, daily spend, sandbox, logging, mobile & network access |
| Logs | Live scrollable feed of instance log entries |
| Slack | Slack app tokens, Socket Mode bridge, and channel↔project bindings |
| Providers | Connect AI providers and manage API keys |
| Models | Enable or disable text and image models |
| Statistics | Per-tool and per-model latency statistics |
| History | Browse and search past conversations |
| Account | Prompt balance and subscription plans (hidden on mobile) |
The sidebar label for app-wide preferences is Settings (route /settings/general), not “General”.
Chat Header Extras
Section titled “Chat Header Extras”The ⋯ More options menu also includes:
- Commands — manage project shell commands (separate from slash commands)
- History — quick jump to recent conversations (distinct from Settings → History)
- Feedback — report bugs or share suggestions
- Processes — view running background processes
App Updates
Section titled “App Updates”When a new version is available, Upgrade to Latest appears on the projects home screen. Click it to download and apply the update without leaving the app.
Related
Section titled “Related”- General Settings — appearance, spend, network access, sandbox
- Mobile App — native iOS and Android app, QR code connection
- Slack — control Tarsk from Slack channels
- Logs — live instance log feed
- Statistics — tool and model latency
- Account — prompt balance and billing
- Project Settings — per-project configuration