Project Settings

The Project Settings dialog lets you update the core configuration for a project. Open it by clicking the Settings icon (gear) next to the project name in the sidebar, or from the project’s context menu.

Settings Reference

Name

The display name for the project shown in the sidebar and on the welcome screen card. Changing the name does not affect the repository or any thread directories.

Setup Script

A shell command that runs automatically in a new thread’s directory immediately after the thread is created (i.e. after the clone completes).

Examples:

npm install
bun install
pip install -r requirements.txt
cargo build
bundle install

The script runs in the thread’s working directory. If it fails, the thread is still created but a warning is shown. Leave this blank if no initial setup is needed.

Run Command

The command used by the Run/Stop button in the toolbar to start your development server.

Examples:

bun dev
npm run dev
python manage.py runserver
rails server

Each thread has its own independent instance of this process. See Dev Server for details on starting, stopping, and viewing output.

Commit Method

Controls how the Git Ops button handles finished work:

Method	Behaviour
pull-request	After committing and pushing, Tarsk creates a pull request on GitHub using the gh CLI. Recommended for team projects where changes go through review.
direct	Commits are pushed directly to the thread’s branch. Suitable for personal projects or when you handle PRs yourself.

The gh CLI must be installed and authenticated for the pull-request method. See git.io/gh for setup instructions.

Open With

The preferred application used when clicking Open With in the toolbar. Choose from:

• VS Code
• Cursor
• Windsurf
• Xcode
• Android Studio
• Kiro
• Terminal

This preference is stored per-project and applies to all threads.

Deleting a Project

To delete a project, click Delete Project at the bottom of the settings dialog. A confirmation dialog lists all threads that will be removed. Deletion removes the project record and all thread directories from disk. This cannot be undone.