# Installation

{% hint style="info" %}
Catana can only be installed on GitHub repositories at the moment.
{% endhint %}

### <mark style="color:blue;">Installing the Catana's GitHub application</mark>

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

<figure><img src="/files/K1nblCfQvQQKsXmSaaDX" alt="" width="563"><figcaption><p><strong>Install the GitHub application.</strong></p></figcaption></figure>

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

<figure><img src="/files/A9o2ZWIjsp2y1fgFXPGB" alt="" width="563"><figcaption><p><strong>Choose the organization where you would like to install Catana.</strong></p></figcaption></figure>

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

### <mark style="color:blue;">Enrol repositories</mark>

{% hint style="info" %}
Manually enrolling a repository allows each team and project to decide whether they'd like to opt-in.
{% endhint %}

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.

<figure><img src="/files/O8LFnwJF6XEa5wqTog8l" alt="" width="563"><figcaption><p><strong>Enrol your repository and discover Catana!</strong></p></figcaption></figure>

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.catana.dev/overview/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.