Skip to main content
A project maps a GitHub repository to your Gentic workspace. When you assign an issue to a project, the AI agent clones that repository, runs your setup script, and begins coding — so every project you create becomes a codebase your agents can work in. You manage projects from the Settings → Workspace page.

​
Add a Project

1

Open Settings

Navigate to Settings in the sidebar, then select Workspace.
2

Fill in the project form

In the Add project card on the left, complete the Name, Repo, and optional Setup script fields (see Field reference below).
3

Submit

Click Add project. The new project appears immediately in the project list on the right.

​
Field Reference

​
name
string
required
A human-readable display name for the project, shown throughout the Gentic UI and when selecting a project for a new issue. Maximum 120 characters.
​
repo
string
required
The GitHub repository the agent will clone, in owner/repo format — for example, kprovorov/gentic. The value must match the exact owner and repository name as they appear on GitHub.
​
setup_script
string
An optional shell script that runs inside the cloned repository before the agent starts writing code. Use this field to install dependencies or perform any other environment setup the agent needs. For example:
npm install
You can include multiple commands separated by newlines.
Always include a setup script that installs your project’s dependencies. Agents start coding immediately after the script finishes, so a missing npm install or pip install -r requirements.txt will cause the agent to fail on import errors.

​
Edit a Project

Each project card in the project list is an editable form. Update the Name, Repo, or Setup script fields directly in the card, then click Save to apply your changes.

​
Delete a Project

To remove a project, click the trash icon (delete button) inside the project card. The project is deleted immediately.
Deleting a project does not delete any GitHub issues or pull requests associated with it. Your GitHub repository and its history remain completely untouched — only the Gentic project record is removed.