Projects Overview
A Project in Tarsk represents a single git repository. It is the top-level organisational unit: everything — threads, conversations, commands, settings — belongs to a project.
What a Project Contains
Section titled “What a Project Contains”| Field | Description |
|---|---|
| Name | Display name shown in the sidebar and welcome screen |
| Git URL | The remote origin URL used when cloning |
| Path | Local path to the primary (non-thread) clone |
| Threads | List of all threads created from this project |
| Setup Script | Shell command run automatically after cloning (e.g. npm install, bun install) |
| Run Command | Dev server command used by the Run/Stop button (e.g. bun dev, npm run dev) |
| Open With | Preferred IDE or tool to open thread directories (VS Code, Cursor, Windsurf, Xcode, Android Studio, Kiro, Terminal) |
| Commit Method | How finished work is submitted: pull-request (creates a PR) or direct (commits directly to the branch) |
| Commands | Custom per-project shell commands accessible from the toolbar |
The Welcome Screen
Section titled “The Welcome Screen”The welcome screen shows a card for each project you have connected. Each card shows the project name and the number of threads. Click a card to expand the project in the sidebar and select a thread.
From the welcome screen you can also:
- Connect Repo — clone an existing repository by git URL
- New App — scaffold a new project from a template
Project vs Thread Storage
Section titled “Project vs Thread Storage”The project record in the database stores metadata and configuration. The actual code lives inside thread directories: each thread gets a full independent clone at ~/Library/Application Support/Tarsk/data/{threadId}/. The project’s own path is used for reference and setup, but day-to-day work happens inside threads.
Next Steps
Section titled “Next Steps”- Create a Project — clone a repo or scaffold a new app
- Project Settings — update name, scripts, and commit method
- Commands — add custom shell commands to the project toolbar