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

# Discovery

> Scan devices for installed AI tools and schedule recurring scans

`unbound discover` scans a device for installed AI coding tools and reports findings to Unbound. This powers the AI Tools inventory and fleet visibility in the dashboard.

Tools detected: Cursor, Claude Code, Gemini CLI, Codex, Windsurf, Roo Code, Cline, GitHub Copilot, JetBrains, and more.

## Prerequisites

Python 3 and `curl` must be available on the device.

The `--api-key` used here is a **discovery key** — separate from your login credentials. Get it from **Connect → AI Coding Tools** in the Unbound dashboard.

## Run a scan

```bash theme={null}
# Scan the current user only:
unbound discover --api-key <DISCOVERY_KEY>

# Scan all users on the device (requires root):
sudo unbound discover --api-key <DISCOVERY_KEY>

# Scan against a custom backend:
sudo unbound discover --api-key <DISCOVERY_KEY> --domain https://backend.acme.com
```

## Schedule recurring scans (macOS)

Set up a LaunchAgent that runs a scan every 12 hours:

```bash theme={null}
unbound discover schedule --api-key <DISCOVERY_KEY>
```

Check schedule status and log paths:

```bash theme={null}
unbound discover status
```

Remove the schedule:

```bash theme={null}
unbound discover unschedule
```

***

## One-step user onboarding

`unbound onboard` combines tool setup and discovery into a single command — useful for scripting new user enrollment:

```bash theme={null}
unbound onboard --api-key <USER_KEY> --discovery-key <DISCOVERY_KEY>
```

This runs `setup --all` (Cursor + Claude Code hooks + Codex hooks) and then performs a device scan.

***

## MDM device onboarding (admin, requires root)

For fleet-wide enrollment from an MDM system:

```bash theme={null}
sudo unbound onboard-mdm --admin-api-key <ADMIN_KEY> --discovery-key <DISCOVERY_KEY>
```

This configures all users on the device (via `setup mdm --all`) and then performs a full device scan.

<Note>
  See [MDM Integrations](/mdm-integrations/overview) for deployment guides and MDM-specific configuration.
</Note>

<CardGroup cols={2}>
  <Card title="MDM Integrations" icon="building" href="/mdm-integrations/overview">
    Connect your MDM provider and deploy AI tools at scale
  </Card>

  <Card title="Analytics" icon="chart-line" href="/analytics">
    View discovered tools and fleet activity in the dashboard
  </Card>
</CardGroup>
