Skip to content
Tarsk

Threads Overview

A Thread (labeled Branch in the UI) is an isolated workspace for working on a project. Each thread is:

  • A full clone of the project’s repository in its own directory
  • On its own git branch
  • Paired with an independent chat session with the AI agent
  • Configured with its own model preferences

Open dock panels from the chat dock taskbar:

PanelPurpose
ChatInteract with the AI agent
FilesBrowse and edit files in the branch directory
ReviewView diffs and review changes
BrowserPreview the running dev server
TerminalRun ad-hoc shell commands
TasksManage project tasks

When you ask the AI agent to make changes, it operates inside that thread’s clone — never touching any other thread or the original project directory.

Why Threads Exist

Section titled “Why Threads Exist”

Traditional AI coding tools operate on a single shared copy of your codebase. This creates a problem: if you want to try two different approaches to the same feature, or work on two issues simultaneously, edits conflict.

Threads solve this by giving each line of work its own isolated environment. You can:

  • Run the agent on feature A in thread 1 while reviewing feature B in thread 2
  • Try two completely different approaches to a refactor and cherry-pick the better result
  • Keep a “clean” thread for reference while experimenting in another
  • Work on a bug fix in one thread while a new feature is being developed in another

Each thread has its own git branch, so merging the result back is a standard git merge or pull request.

Thread Storage

Section titled “Thread Storage”

Threads are stored at:

~/Library/Application Support/Tarsk/data/{repo-slug}/

The folder name comes from the project’s git URL (e.g. https://github.com/org/repo → org-repo). If that name is already taken, Tarsk appends -1, -2, and so on. Each path is a full git clone on disk. Open it in any IDE, run commands in it, or inspect it with git tools. Agent changes are real filesystem writes, not diffs or patches.

Thread State

Section titled “Thread State”
FieldDescription
TitleHuman-readable name (e.g. “Add login page”)
BranchAuto-generated from the title (e.g. add-login-page)
Current ConversationThe active conversation ID within this thread
Statusactive or deleted

Next Steps

Section titled “Next Steps”