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?