> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vaultak.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart - Vaultak Sentry

> Monitor any AI agent with zero code changes using the Vaultak Sentry desktop app

Vaultak Sentry is a desktop application for macOS, Windows, and Linux that monitors any AI agent running on your machine without requiring any changes to the agent code. Install it in two minutes and get full behavioral monitoring immediately.

## Download

Download the installer for your platform from [vaultak.com/download](https://vaultak.com/download):

| Platform              | File                               |
| --------------------- | ---------------------------------- |
| macOS (Apple Silicon) | `VaultakSentry-1.0.0-arm64.pkg`    |
| Windows               | `VaultakSentry-1.0.0-windows.zip`  |
| Linux                 | `VaultakSentry-1.0.0-linux.tar.gz` |

## Installation

### macOS

1. Download `VaultakSentry-1.0.0-arm64.pkg`
2. **Right-click** the file and select **Open**
3. Click **Open** in the security dialog
4. Follow the installer prompts

### Windows

1. Download `VaultakSentry-1.0.0-windows.zip`
2. Extract the zip file
3. Run `VaultakSentry.exe`
4. If SmartScreen appears, click **More info** then **Run anyway**

### Linux

\`\`\`bash
tar -xzf VaultakSentry-1.0.0-linux.tar.gz
cd VaultakSentry-1.0.0
./VaultakSentry
\`\`\`

## Connect to your account

1. Open the Vaultak Sentry app
2. Enter your API key from [app.vaultak.com](https://app.vaultak.com)
3. Click **Connect**
4. The status indicator turns green, monitoring has begun

## Run your agent through Sentry

Instead of running your agent directly:

```bash theme={null}
python my_agent.py
```

Run it through Sentry:

```bash theme={null}
vaultak-sentry run python my_agent.py
```

That is the only change. Works with any language:

```bash theme={null}
# Python
vaultak-sentry run --name my-agent python my_agent.py

# Node.js
vaultak-sentry run --name my-agent node my_agent.js

# Any executable
vaultak-sentry run --name my-agent ./my_agent
```

With custom thresholds:

```bash theme={null}
vaultak-sentry run --name my-agent --alert-threshold 30 --pause-threshold 60 --rollback-threshold 85 python my_agent.py
```

Block specific resources:

```bash theme={null}
vaultak-sentry run --name my-agent --block "*.env" "prod.*" python my_agent.py
```

## Configure thresholds

| Threshold    | Default | Behavior                           |
| ------------ | ------- | ---------------------------------- |
| **Alert**    | 30      | Log event and send notification    |
| **Pause**    | 60      | Halt agent, queue for human review |
| **Rollback** | 85      | Auto-reverse state, halt agent     |

Thresholds can be adjusted at any time without restarting the app.

## What Sentry monitors

* **Network connections**, every outbound API call and external service connection
* **File system**, reads, writes, and deletes by agent processes
* **LLM API calls**, requests to OpenAI, Anthropic, and other providers
* **Process activity**, subprocesses spawned by agents

## Privacy

Sentry monitors that actions occur, it does not read file contents or environment variable values. Data sent to Vaultak servers: action type, resource path or hostname, timestamp, and risk score only.

## Frequently asked questions

**Do I need to modify my agent code?**
No. Sentry monitors at the network and OS level.

**Will Sentry slow down my agent?**
No. Sentry runs as a separate background process and does not intercept or delay agent actions.

**I see a security warning on macOS. Is this normal?**
Yes. Right-click the installer and select Open to bypass the Gatekeeper warning. This is standard for apps not yet signed with an Apple Developer certificate.

**Can I use Sentry and Core together?**
Yes. Events from both products appear in the same dashboard.

## Next steps

* [View your agents in the dashboard](https://app.vaultak.com)
* [Learn about the Core SDK for programmatic integration](/quickstart)
* [Read the full API reference](/api-reference)
