Catana Documentation
  • 🐱Overview
    • Introduction
    • Installation
  • 📖Core concepts
    • Regular and expiring TODOs
    • Assigning TODOs
    • Create, update and delete
    • Validation
    • Ignored TODOs
  • 🔔Triggers
    • Overview
    • Date
    • GitHub Issue closed
    • GitHub Pull Request closed
    • Ruby Gem released
    • Ruby Gem upgraded
    • Ruby Version released
    • Ruby Version upgraded
  • 🤖Commands
    • Overview
    • Done
    • Bump
    • Link
  • 🔗Grouped TODOs
    • Overview
  • ⚙️Configuration
    • Open GitHub issues
    • Enforce expiring TODOs
    • Rules
    • Exclusion list
Powered by GitBook
On this page
  • Installing the Catana's GitHub application
  • Enrol repositories

Was this helpful?

  1. Overview

Installation

You are just a click away from installing Catana.

PreviousIntroductionNextRegular and expiring TODOs

Last updated 9 months ago

Was this helpful?

Catana can only be installed on GitHub repositories at the moment.

Installing the Catana's GitHub application

The first time you sign in to Catana, you will be prompted to install the application and will be redirected to GitHub.

Choose the account on which you would like to proceed with the installation, and click "Install". Congratulations, you have successfully installed Catana! 🥳

Once Catana is installed, other members of your organization will not be prompted to follow this step.

Enrol repositories

Manually enrolling a repository allows each team and project to decide whether they'd like to opt-in.

After installing the GitHub application, you'll be redirected back to Catana where you'll choose which repositories you'd like to enrol. You can choose as many repositories as you want!

Enrolling a repository enables the following functionalities:

  • 🔍 Let Catana search and process existing TODOs.

  • 💾 Record upcoming TODOs whenever a git push occurs on the release branch (usually main or master).

  • ✅ Add a failing or successful CI check status on Pull Requests introducing a TODO.

This operation can take a few minutes based on how large the repository is and the number of TODOs found.

🐱
Install the GitHub application.
Choose the organization where you would like to install Catana.
Enrol your repository and discover Catana!