Skip to content
Tarsk

Create a Project

Create a project from the projects home screen welcome cards, or from the sidebar + menu (New Project dropdown).

UI labelWhat it does
Connect a repo (welcome card) / Git Repo (+ menu)Clone from a git URL
Open FolderConnect a local directory
New AppScaffold from a template
Blank Starter (+ menu)Empty workspace folder

Git Repo (Clone)

Section titled “Git Repo (Clone)”
  1. On the welcome screen, click Connect a repo, or choose Git Repo from the + menu.
  2. Paste the git URL of the repository (HTTPS or SSH). For example: 
    https://github.com/your-org/your-repo.git
    [email protected]:your-org/your-repo.git
  3. Click Clone.

Tarsk clones the repository into its data directory. This can take a few seconds for large repositories. Once cloned, the project appears on the projects home grid.

Setup Script Confirmation

Section titled “Setup Script Confirmation”

After cloning, Tarsk checks the repository for a common setup script (package.json, bun.lockb, Cargo.toml, etc.). If one is found, a confirmation dialog appears:

“This project has a setup script. Run it now?”

Click Run to execute the setup script (e.g. npm install, bun install, cargo build) in the project directory. This prepares dependencies so that branches are ready to use immediately after creation.

You can also configure or change the setup script later in Project Settings.

Blank Starter

Section titled “Blank Starter”

Create a blank project folder inside the Tarsk workspace:

  1. Click + on the projects home screen and choose Blank Starter.
  2. Enter a folder name and confirm.

Tarsk creates an empty directory under its data path and registers it as a project. Use this when you want a clean workspace before adding files or initializing git yourself.

Open Folder

Section titled “Open Folder”

If you already have a project directory on your machine, connect it directly without cloning:

  1. Click Open Folder on the welcome screen or in the + menu.
  2. Select the directory in the file picker dialog.
  3. Tarsk registers the directory as a project.

The folder is used as-is — no cloning or copying happens. Branches created from this project will clone from the directory’s git repository (if it has one) or copy the directory contents.

This is useful for:

  • Projects you are already working on locally
  • Monorepos or worktrees you want to connect without re-cloning
  • Directories without a git remote (local-only projects)

New App (Scaffold from Template)

Section titled “New App (Scaffold from Template)”
  1. Click New App on the welcome screen or in the + menu.
  2. Choose a template from the list.
  3. Choose a package manager: bun, npm, yarn, or pnpm.
  4. Give the project a name and click Create.

Tarsk runs the appropriate scaffold command, initialises a git repository, and registers the project so it’s immediately ready for branches and the AI agent.

Templates cover React, Next.js, Vue, Nuxt, Svelte, Solid, Angular, Astro, Capacitor, and more. See Project Templates for the full list.

After Creating a Project

Section titled “After Creating a Project”

Once a project exists: