Skip to content
tarsk

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 pointOpens
Profile button at the bottom of the activity bar (its tooltip shows your email when signed in)Profile menu (spend, sign out, settings)
Project settings cog in the sidebar footerProject settings for that project
VS Code embed Settings buttonGeneral settings only

Project Scope Sidebar

Section titled “Project Scope Sidebar”

When Project is selected and a project is active, these items appear:

ItemPurpose
SettingsProject name, project icon, and instructions (AGENTS.md)
PluginsSkills, MCP, system prompt, tools, slash commands, subagents
SetupSetup script, run command, commit method, built-in browser
VariablesEncrypted key/value pairs injected into agent shell sessions
Danger ZoneDelete 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:

ItemPurpose
PluginsSkills, MCP, system prompt, tools, slash commands, and subagents
SettingsFont size, appearance, max turn count, voice cleanup, sandbox, logging
ProvidersConnect AI providers and manage API keys
Remote AccessMobile & network access, public address, QR code, Remote Machines (guide)

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”.

Activity Bar Menu

Section titled “Activity Bar Menu”

The ⋯ More actions menu at the top of the activity bar holds:

  • New Bot: create a bot project
  • New Project: clone a repository, open a folder, import a zip, or scaffold an app
  • Scripts and Commands: run package scripts and the project’s custom shell commands (shown while a project and thread are selected)
  • Open With: open the workspace in an editor
  • Settings: app-wide preferences at /settings/general
  • Providers: connect AI providers and manage API keys
  • 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.

Section titled “Related”