# Link

{% hint style="info" %}
The **`@CatanaCorp link`** command can be invoked by commenting on a Pull Request.
{% endhint %}

#### <mark style="color:blue;">When to use it</mark>

A common convention is to require each TODO to have an associated issue, with the TODO referencing the issue number.\
This workflow is tedious, as developers need to manually create an issue for each TODO, update the codebase to link the issue number, commit the changes, and finally push to Git.

**Catana automates this process, saving you and your team valuable time.**

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

➡️ **`@catanacorp`**<mark style="color:purple;">**`link`**</mark>

This command performs the following actions:

* Parses the Pull Request changes and detects new TODO annotations.
* Opens a GitHub issue for each new TODO item.
* Edits each TODO in the codebase to reference the corresponding issue. The changes made by the Catana bot are not pushed to your branch but are provided as GitHub suggestions, which you can apply with a single click.

<figure><img src="/files/3YGTM5GC375dtoafPjjy" alt=""><figcaption></figcaption></figure>


---

# 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/commands/link.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.