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 accessible from the chat header |
| 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.
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