# AI-Assisted Integration

### How to use this

This curated AI prompt is designed to get the freeRASP into your app to save you time. The AI cannot make security decisions for you.

{% hint style="warning" %}
**CRITICAL: This AI integration is a starting point only. You MUST manually configure:**

* Signing certificate hash
* Watcher email
* Threat reactions 

**Commit your code before starting so you can review/rollback changes.**
{% endhint %}

#### Steps

1. ➡️ Open your AI coding assistant & your IDE
2. ➡️ Proceed with steps related to your AI coding assistant (see tabs below)
3. **⚠️** Finally, read <https://docs.talsec.app/freerasp/integration/android> again and **manually configure TalsecConfig and threat reactions**

Choose your AI assistant:

{% tabs %}
{% tab title="Cursor " %}

1. Create an **Integration.md** file inside your app folder.
2. Navigate to[ https://docs.talsec.app/freerasp/integration/android](https://docs.talsec.app/freerasp/integration/android). In the top right corner, click the arrow next to the copy button and choose the "Copy page" option.

<figure><img src="https://3557356308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ2PxZTOjhquOxcxftTrm%2Fuploads%2FGZ5mVIpn0QA00F5cKMTD%2Fimage.png?alt=media&#x26;token=4fc85815-f277-48c7-943f-0dbf6f1adef7" alt=""><figcaption></figcaption></figure>

3. Paste the content into your newly created **Integration.md** file.

<figure><img src="https://3557356308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ2PxZTOjhquOxcxftTrm%2Fuploads%2Fjb7dWF5CSbfdwlKKLVLf%2Fimage.png?alt=media&#x26;token=27235dd3-b157-4914-8050-2c9924b872bd" alt=""><figcaption></figcaption></figure>

4. Afterwards start Cursor inside your app folder and run this **prompt**:

{% code overflow="wrap" %}

```
Integrate free RASP into `your app` folder, while following the guide inside `Integration.md`. Check that integration was done correctly by building the app with gradle files. You are **PROHIBITED** from modifying any code in the target app that is not explicitly mentioned in the guide. Do not refactor or "improve" unrelated existing logic. 

Take a look at this link “https://raw.githubusercontent.com/talsec/Free-RASP-Android/refs/heads/master/FreeRASPDemoApp/app/src/main/java/com/aheaditec/talsec/demoapp/TalsecApplication.kt”, It is reference integration, please follow it, especially imports. Replace any TODO comments found in the integration steps (specifically within callbacks or event handlers) with executable print functions (e.g., Log.d or println) containing relevant logging text, ensuring the events are observable. 

After the integration, mention to the user what he needs to do next, according to the guide. For the `expectedSigningCertificateHashBase64`, you must explicitly provide the link `https://docs.talsec.app/freerasp/wiki/getting-signing-certificate-hash` and instruct the user to follow that guide to obtain the correct hash for their certificate.
```

{% endcode %}

5. After a successful build of your app with freeRASP integrated, **the LLM will provide you with the next integration steps**.
   {% endtab %}

{% tab title="Claude Code" %}

1. Create an **Integration.md** file inside your app folder.
2. Navigate to[ https://docs.talsec.app/freerasp/integration/android](https://docs.talsec.app/freerasp/integration/android). In the top right corner, click the arrow next to the copy button and choose the "Copy page" option.

<figure><img src="https://3557356308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ2PxZTOjhquOxcxftTrm%2Fuploads%2FGZ5mVIpn0QA00F5cKMTD%2Fimage.png?alt=media&#x26;token=4fc85815-f277-48c7-943f-0dbf6f1adef7" alt=""><figcaption></figcaption></figure>

3. Paste the content into your newly created **Integration.md** file.

<figure><img src="https://3557356308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ2PxZTOjhquOxcxftTrm%2Fuploads%2Fjb7dWF5CSbfdwlKKLVLf%2Fimage.png?alt=media&#x26;token=27235dd3-b157-4914-8050-2c9924b872bd" alt=""><figcaption></figcaption></figure>

4. Create the **CLAUDE.md** file in your app folder with the content from the link

{% file src="<https://3557356308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ2PxZTOjhquOxcxftTrm%2Fuploads%2F68iC5AbH4jCnRcfw2bai%2FCLAUDE.md?alt=media&token=46ef3959-09d2-48c3-b15e-8109006a8458>" %}

5. Now, launch **Claude** in your app folder and type **start**. Grant the LLM the necessary permissions when prompted. After a successful build of your app with freeRASP integrated, the LLM will provide you with the next integration steps.
   {% endtab %}

{% tab title="Codex" %}

1. Create an **Integration.md** file inside your app folder.
2. Navigate to[ https://docs.talsec.app/freerasp/integration/android](https://docs.talsec.app/freerasp/integration/android). In the top right corner, click the arrow next to the copy button and choose the "Copy page" option.

<figure><img src="https://3557356308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ2PxZTOjhquOxcxftTrm%2Fuploads%2FGZ5mVIpn0QA00F5cKMTD%2Fimage.png?alt=media&#x26;token=4fc85815-f277-48c7-943f-0dbf6f1adef7" alt=""><figcaption></figcaption></figure>

3. Paste the content into your newly created **Integration.md** file.

<figure><img src="https://3557356308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ2PxZTOjhquOxcxftTrm%2Fuploads%2Fjb7dWF5CSbfdwlKKLVLf%2Fimage.png?alt=media&#x26;token=27235dd3-b157-4914-8050-2c9924b872bd" alt=""><figcaption></figcaption></figure>

4. Create the **AGENTS.md** file in your app folder with the content from the link.

{% file src="<https://3557356308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ2PxZTOjhquOxcxftTrm%2Fuploads%2Frz0A8SQxDB4bCieseGOo%2FAGENTS.md?alt=media&token=eace968e-3d36-405a-bb36-4dc9d5f113e0>" %}

5. Now, launch **Codex** in your app folder and type **start**. Grant the LLM the necessary permissions when prompted. After a successful build of your app with freeRASP integrated, the LLM will provide you with the next integration steps.
   {% endtab %}

{% tab title="Gemini CLI " %}

1. Create an **Integration.md** file inside your app folder.
2. Navigate to[ https://docs.talsec.app/freerasp/integration/android](https://docs.talsec.app/freerasp/integration/android). In the top right corner, click the arrow next to the copy button and choose the "Copy page" option.

<figure><img src="https://3557356308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ2PxZTOjhquOxcxftTrm%2Fuploads%2FGZ5mVIpn0QA00F5cKMTD%2Fimage.png?alt=media&#x26;token=4fc85815-f277-48c7-943f-0dbf6f1adef7" alt=""><figcaption></figcaption></figure>

3. Paste the content into your newly created **Integration.md** file.

<figure><img src="https://3557356308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ2PxZTOjhquOxcxftTrm%2Fuploads%2Fjb7dWF5CSbfdwlKKLVLf%2Fimage.png?alt=media&#x26;token=27235dd3-b157-4914-8050-2c9924b872bd" alt=""><figcaption></figcaption></figure>

4. Create the **GEMINI.md** file in your app folder with the content from the link.

{% file src="<https://3557356308-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQ2PxZTOjhquOxcxftTrm%2Fuploads%2FHL6XEYqoSutpmqBJVFgQ%2FGEMINI.md?alt=media&token=24cd01e8-9e62-4a06-8ff7-2a0070e570e3>" %}

5. Now, launch **gemini cli** in your app folder and type **start**. Grant the LLM the necessary permissions when prompted. After a successful build of your app with freeRASP integrated, the LLM will provide you with the next integration steps.
   {% endtab %}
   {% endtabs %}


---

# 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.talsec.app/freerasp/freerasp/integration/android/ai-assisted-integration.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.