Projects Overview
A Project in Tarsk represents a single git repository. It is the top-level organisational unit: workspaces, conversations, commands, and settings all belong to a project.
What a Project Contains
Section titled “What a Project Contains”| Field | Description |
|---|---|
| Name | Display name on the projects home grid |
| Git URL | The remote origin URL used when cloning |
| Path | Local path to the canonical checkout, shared with the initial thread |
| Workspaces | Thread workspaces; additional workspaces use separate clones or copies |
| Setup Script | Shell command run automatically after a new workspace is created |
| Run Command | Dev server command for the Run/Stop button |
| Commit Method | pull-request or direct |
| Commands | Custom shell commands run from the More actions menu |
| Env Vars | Encrypted environment variables for agent shell sessions |
The Projects Home Screen
Section titled “The Projects Home Screen”The projects home screen shows an icon grid of connected projects. Click a project icon to open it. The account menu in the sidebar footer opens app-wide settings. The New Project menu offers Blank Starter, Git Repo, Open Folder, From Zip, and New App. New Bot creates a bot project.
Project vs Workspace Storage
Section titled “Project vs Workspace Storage”Tarsk stores project metadata and settings in its local database. The initial thread shares that checkout; Open Folder uses your selected directory. Additional workspaces get separate clones or copies under ~/Library/Application Support/Tarsk/data/{repo-slug}/ (e.g. repo from https://github.com/org/repo, with -1, -2 suffixes on conflict).
Next Steps
Section titled “Next Steps”- Create a Project — clone a repo, open a folder, or scaffold a new app
- Project Settings — update name, scripts, and commit method
- Commands — add custom shell commands
- Rules — configure AI agent behavior guidelines
- AGENTS.md — provide workspace-level context to the agent