Full size image
Tutorial

Getting Started with tulpal

Here's how to quickly configure your first project and let your pals take over the work.

Step 1: Create a Project

Once you've logged into the tulpal portal, the first step is to create a project. A project in tulpal corresponds links three important assets: git repository + issue tracker + coding agent.

  1. Enter the git URL of your repository (e.g., https://github.com/your-username/your-repo.git).
    Enter git URL
  2. tulpal will now check the URL and if it looks fine, it will suggest a project name. You can either edit the name to your preferences, or accept the suggested name.
    Project name suggestion
  3. Also, please select the coding agent you'd like to use. You can later change the coding agent.
    Select coding agent

Now, tulpal will need access to your code repository, ticket tracker and coding agent. If code and issues are colocated in the same repository, only one access token is needed for that.

  1. Enter the git URL of your repository (e.g., https://github.com/your-username/your-repo.git).
  2. Configure any necessary authentication credentials if your repository is private.
  3. Click "Create Project" to initialize the project.

Step 2: Assign Issues to tulpal

tulpal watches your repository for issues that are assigned to it. To make an issue available to tulpal, you simply need to add a specific label. All other tickets will be ignored by tulpal.

Adding the Label

Go to your issue tracker (GitHub, GitLab, etc.) and add the label tulpal-start to any issue you want the agent to work on.

Label: tulpal-start

Task Execution

Once the label is added, tulpal will pick up the issue within a few seconds and create show corresponding task in the system. Depending on already running tasks, the task is executed eventually.

Step 3: Watch the AI do the work

You'll notice when tupal starts working on the task. You can monitor the progress in the tulpal portal. Or, even better, use the time and do something else.

  • The agent will analyze the codebase.
  • It will plan the changes.
  • It will implement the solution and run tests.
  • Finally, it will add a comment to your ticket with a link to the generated commit and branch.

Step 4: Take over the task, or repeat

If the task has been implemented successfully, good for you! Otherwise, you have two possibilities:

  • Take over yourself, by working on the branch.
  • Or, amend the original ticket and wait until tulpal picks it up again. You will now have to run the task manually, by clicking "Force Run" on the task's detail page..