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

​
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.
​
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.
​
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:
You can include multiple commands separated by newlines.
​
boolean
default:"true"
Controls whether Gentic automatically feeds Request changes reviews on the project’s pull requests back to the agent that opened them. When enabled (the default), a changes_requested review — including its body and inline comments — is appended to the issue’s transcript and the run is re-queued, so the agent pushes fixes to the same PR branch without a human relaying the feedback.Uncheck Auto-respond to review feedback on the project card to keep the older behavior: the issue still moves to changes-requested, but no run is queued and you decide when to respond.See GitHub Integration for the webhook and credential setup required to make this work.
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 also deletes its Gentic issues through the database cascade. It does not delete the GitHub repository or any pull requests already created there.