What is a code repository and how to add yours to Suricode — Suricode

Blog

What is a code repository and how to add yours to Suricode

· Mark Bacsko · 5 min read

What is a code repository and how to add yours to Suricode

You built an app with Lovable, Bolt, v0, Replit, or Cursor. Suricode then asks where the code lives. That question is easier than it sounds.

A repository (people say "repo") is the folder your app's code lives in, plus a history of every change. Suricode reads that folder and tells you what to fix, in plain words. It does not change the app.

The live website is the app after it has been published. Suricode wants the folder the site was built from.

If you are not sure, start here

Pick the line that sounds like you.

  • The app is already on github.com, or the tool says it is connected to GitHub. Choose GitHub.
  • The link says bitbucket.org. Choose Bitbucket.
  • You built it in Lovable, Bolt, v0, Replit, or Cursor, and it is not on a site yet. Choose Hosted by Suricode. Or paste the prompt below and let the agent put it on a new private GitHub repo.
  • The link says gitlab.com, or you can see a Code or Clone button that is not GitHub. Choose Another git address.
  • Your team uses Origin. If you have never heard of Origin, skip it.

A git address is the https link that usually ends in .git. It is how a tool sends or reads the code. You do not need to memorize that. The prompts below ask the agent to find it.

Paste this into Cursor, Claude Code, Lovable, Bolt, or Replit:

Where is the source code for this app? If it is already on GitHub, GitLab, Bitbucket, or Origin, tell me the link. If it is only in this tool or in a folder on my computer, create a new private GitHub repository, push the code there, and give me the link. Do not add secrets, tokens, or passwords to the repository or the chat.

Push means send the code to that place. A token is a password made for one job. The prompt tells the agent not to show one, and not to save one in the project.

GitHub

Use this when the app is already on GitHub. Continue, sign in there, and tick the projects Suricode may read. Your password stays on GitHub. Suricode can look at the code and cannot change it.

Bitbucket

Use this when the app is already on Bitbucket. Sign in there and pick the projects from the list. Suricode can look at the code and cannot change it.

Origin

Origin is a site some teams use to keep code, like GitHub. If you have never seen it, this is not your option.

  1. Choose Origin. Suricode sends you there.
  2. The person who manages that Origin workspace installs Suricode and ticks the projects it may read. Suricode only gets permission to look.
  3. You come back. Each project is added and checked.
  4. If Origin is only a copy of a GitHub project, use GitHub instead. Suricode will say so.
Is this project stored on Origin, or is Origin only a copy of a GitHub project? Reply with the link, or tell me to use GitHub instead. Do not create tokens, and do not print passwords.

Another git address

Use this for GitLab, or any Code button that is not GitHub or Bitbucket.

  1. Open the project. Find Code or Clone. Copy the https address.
  2. In Suricode, choose Another git address, name the project, and paste the address.
  3. If the project is private, the site can make a read-only access token. That is a password that can only read. Create it on that site and paste it into Suricode, not into the chat.
  4. Leave the branch as it is. A branch is the version you ship. The default one is almost always right.
Find the https git address for this project. It usually ends in .git and sits under a Code or Clone button. Tell me that address only. If the project is private, tell me where I create a read-only access token. Do not create the token, and do not print any token or password.

Hosted by Suricode

Use this when the app is not on GitHub yet. You built it in Lovable, Bolt, v0, Replit, or Cursor, or you only have a zip. A zip is a download of the project folder. Suricode keeps a private repo for you. You can have 5, up to 1 GB each.

  1. Choose Hosted by Suricode and give the project a short name.
  2. Suricode shows a git address and a push token. A push token is a password for that link, shown once.
  3. Paste the prompt below into the tool that built the app. When it asks for a password, type the push token yourself. Do not paste the token into the chat.
  4. The first check starts when the code arrives.
Send this project to the private place Suricode made for me. The git address is on the Suricode page and starts with https://. Push the main branch there. When git asks for a password, stop and let me type the push token. Do not print the token, and do not save it in the project.

After it is connected

Suricode reads a private copy and lists what to fix. Leaked keys come first. A leaked key is a password or API key sitting in the code. You can hand the list to your coding agent. Adding a project and running a check is free.