Skip to content
Tarsk

Create a Project

There are two ways to create a project in Tarsk: cloning an existing repository or scaffolding a new application from a template.

Connect Repo (Clone an Existing Repository)

Section titled “Connect Repo (Clone an Existing Repository)”
  1. On the welcome screen, click Connect Repo.
  2. Paste the git URL of the repository (HTTPS or SSH). For example: 
    https://github.com/your-org/your-repo.git
    git@github.com: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 in the sidebar.

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 threads are ready to use immediately after creation.

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

New App (Scaffold from Template)

Section titled “New App (Scaffold from Template)”
  1. On the welcome screen, click New App.
  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 threads and the AI agent.

Available Templates

Section titled “Available Templates”
CategoryTemplates
ReactReact (Vite), Next.js
VueVue (Vite), Nuxt
SvelteSvelte (Vite)
SolidSolid (Vite)
PreactPreact (Vite)
AngularAngular
OtherAstro, Qwik, Lit, Waku, Hydrogen, Capacitor, Web

Templates use the official scaffold tools for each framework (e.g. create-next-app, create-vite, astro). The package manager you choose is used for project creation and is set as the default for the project’s run commands.

After Creating a Project

Section titled “After Creating a Project”

Once a project exists, you’ll want to: