Connect GitHub and set up a repository

Starko works with your code through the Starko GitHub App. Installing it lets projects link repositories, lets Starko AI open pull requests, shows pull request status on tickets, and optionally syncs GitHub issues with tickets.

Install the GitHub App

Open Settings → Integrations and expand GitHub.

Press Install and choose the GitHub account or organisation. Pick the repositories Starko may access; you can add more later with Manage repositories.

Back in Starko, the row shows the connected accounts.

integrations github

Starko never pushes to your default branch and never merges. It creates branches named starko/..., opens draft pull requests and comments on them.

Link a repository to a project

Open a project, then its settings, and choose the repository. One project points at one repository. Tickets in that project can now be handed to Starko AI.

project ai settings

Tell Starko AI how to run your app

In the same settings sheet, fill in:

Agent instructions: stack, conventions, what not to touch.

Project commands: install command, test command, dev server command and app URL.

Sandbox environment variables: what the app needs to install, test and run. Stored encrypted, never shown again. Use test credentials only.

Prepare sandbox builds a snapshot with dependencies installed so runs start fast.

Learn project writes a map of the repository that every run starts from.

Pull requests on tickets

When Starko AI opens a pull request, the ticket shows it in the Development panel and the Starko AI card: number, CI status, risk level and a one-line summary. View PR opens GitHub. With Automated follow-ups on, review comments on the pull request trigger a revision run.

Pull requests you open yourself are linked when the branch name or the pull request body mentions the ticket number.

GitHub issues sync

Per project, you can sync GitHub issues two ways: issues become tickets and tickets become issues, with status and comments kept in step. Public comments go out to GitHub; internal comments stay in Starko. A project can also mirror a GitHub Projects board.

Repository docs

The Knowledge Hub's Repository page shows, per project, the architecture doc and repo learnings Starko AI maintains. See Repository docs: architecture and repo learnings.

kh repository

Permissions the app asks for

Contents, pull requests, issues and checks on the repositories you pick; organisation administration only if you want to create repositories from Starko. Remove the app from GitHub to revoke everything at once.

Did this answer your question?