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, the settings sidebar shows both groups: General for app-wide settings and Project for the selected repository.
Opening Settings
Section titled “Opening Settings”| Entry point | Opens |
|---|---|
| Account menu in the sidebar footer (your name or Anonymous) | General settings, Providers, Account |
| ⋯ More options → Settings in the chat header | Project settings for that project |
| 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, these items appear:
| Item | Purpose |
|---|---|
| Settings | Project name, project icon, and instructions (AGENTS.md) |
| Plugins | Skills, MCP, system prompt, tools, slash commands, subagents |
| Setup | Setup script, run command, commit method, built-in browser |
| Variables | Encrypted key/value pairs injected into agent shell sessions |
| Danger Zone | Delete the project, its threads, and all associated storage |
Plugins holds tabs for Skills, MCP, System Prompt, Tools, Slash Commands, and Subagents.
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 |
|---|---|
| Plugins | Skills, MCP, system prompt, tools, slash commands, and subagents |
| Settings | Font size, appearance, wallpaper, max turn count, voice cleanup, daily spend, sandbox, logging, mobile & network access |
| Providers | Connect AI providers and manage API keys |
| Account | Prompt balance and plans (hidden on mobile) |
Settings holds tabs for General, History, Storage, Statistics, Logs, and Slack. Providers holds tabs for Providers, Default Models, and List.
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)
- Share — export the project’s skills and MCP servers as a plugin, or export the source code
- Processes — view running background processes
App Updates
Section titled “App Updates”When a new version is available, Upgrade to Latest appears in the sidebar footer. 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
- Storage and Cleanup: workspace deletion, Clear History, and local account reset
- Account — prompt balance and billing
- Project Settings — per-project configuration