# Manage Device Agent

## What is the Device Agent?

The Device Agent is a program that runs on your computer and applies the policies defined in Subrosa to protect you while using AI tools.

It can see your traffic to AI providers (but only AI providers) and applies the defined policies and their corresponding actions transparently, you won't know it is there unless it takes an action.

The agent is built to be privacy respecting, it only looks at traffic to a defined set of [AI providers](/ai-provider/ai-provider-support.md) and never sends data off your device.

It is also very light on system resources.

## Create a Device Agent

You can create a Device Agent from the `Device Agent` page. A valid device contact email needs to be provided at this step.

## Downloading the Device Agent

Follow the download links on the `Device Agent` page for your Operating System.

{% hint style="warning" %}
Having trouble downloading the Device Agent? Contact us at <help@subrosa.ai>
{% endhint %}

## Install the Device Agent

See [Installation Steps.](#install-the-device-agent)

## Authenticate the Device Agent

See [Authentication Steps.](#authenticate-the-device-agent)

## Update the Device Agent

See [Updating the agent.](#update-the-device-agent)

## Delete Device Agent

You can delete a `Device Agent` from the `Device Agent List` through the option menu next to a `Device Agent` item.&#x20;

This will remove it from Subrosa, it will no longer be able to send data.

To remove it from your local machine:

1. Open a Terminal ([see here](#authenticate-the-device-agent) if you do not know how)
2. Type `sr-agent uninstall` and hit \<enter>
3. Follow the prompts

## Stop the Device Agent Process on Device

If you want to stop the agent on your local device without unlinking it

{% hint style="info" %}
The agent integrates with the process managers of the operating systems we support, so you will be interacting with these to control its lifecycle

* On Windows that is the Windows Service Manager and its frontend `sc`
* On Mac that is `launchd` and its frontend `launchctl`
* On Linux that is `systemd` and its frontend `systemctl`
  {% endhint %}

1. Windows
   1. Open a Terminal as an Administrator
      1. Press the Windows Start button at the bottom left
      2. Type in "Command Prompt"
      3. Right click on Command Prompt and click "Run as administrator"
      4. Click Yes if the Windows 10 User Account Control prompt is displayed
   2. Type `sc stop SubrosaService` and hit \<enter>
      1. It can be restarted with `sc start SubrosaService`
2. Mac
   1. Open a Terminal
   2. Type `sudo launchctl stop ai.subrosa.service` and hit \<enter>
      1. It can be restarted with `sudo launchctl start ai.subrosa.service`
3. Linux
   1. Open a Terminal
   2. Type `sudo systemctl stop subrosa` and hit \<enter>
      1. It can be restarted with `sudo systemctl start subrosa`

&#x20;


---

# 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.subrosa.ai/device-agent/manage-device-agent.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.