# Install Scope

Scope is a Kubernetes desktop app with an AI agent that investigates the
selected cluster. It supports metrics and log analysis, plus reports that run
on demand or on a schedule.

## Downloads

Version 0.2.2 includes the desktop app and local service. You do not need to
install Node.js or Go separately.

- [macOS DMG (Apple silicon)](https://scopekube.com/downloads/Scope-0.2.2-arm64.dmg)
- [Windows EXE (x64)](https://scopekube.com/downloads/Scope-0.2.2-x64-Setup.exe)
- [SHA-256 checksums](https://scopekube.com/downloads/Scope-0.2.2-SHA256SUMS.txt)

On macOS:

1. Open the DMG.
2. Drag Scope into Applications.
3. Open Scope.

On Windows:

1. Run the installer.
2. Choose an installation folder.
3. Open Scope after installation.

These development builds are unsigned. macOS Gatekeeper or Windows SmartScreen
may block the app when you first open it. Signing and macOS notarization are
not configured. The DMG requires an Apple silicon Mac. It does not support
Intel Macs.

The Windows installer and its x64 contents passed checks on macOS. Native
Windows testing remains pending. Linux requires a source build, and native
Linux testing also remains pending.

## Activate your annual license

Scope requires an annual license at €39 or $49.

1. Save your license key from the payment confirmation page after purchase.
2. Open Scope with an internet connection.
3. Paste the key into the activation screen.

Each successful annual renewal keeps the same key active. Use License in the
app menu or Manage billing on the website to open Stripe billing. You can
cancel future renewals there. You retain access until the end of the period
you paid for.

After each license check, you can use the app offline for up to seven days.
Offline access ends sooner if your paid period ends. Keep your license key
private. Anyone with the key can access your billing settings.

## Connect a cluster

Scope lists your kubeconfig connections alongside two labeled demo clusters.
Choose a connection to browse its resources. Scope keeps your global kubeconfig
current-context unchanged. Use Reload connections after you edit kubeconfig.

## Configure your AI provider

1. Open AI Settings.
2. Choose OpenAI, Anthropic, an OpenAI-compatible API, or a ChatGPT account through a locally installed Codex CLI.
3. Configure the provider and model.
4. Save your settings.

You use your own provider credentials and account. Your provider bills separately. Scope does not include a provider key. Without an AI provider,
Scope runs fixed health checks labeled Local analysis. These checks do not
use an AI model and cannot answer arbitrary questions.

Add notes about your services and environment in Cluster context. Open Agent
to investigate the selected cluster. You can also save and review an inventory
draft in Cluster context.

Your chosen provider receives your question, saved notes, and a limited summary
of evidence. Scope removes known credential patterns and excludes raw YAML and
Secret values. Application logs and saved notes can still contain sensitive
information.

## Create a task

1. Open Tasks.
2. Select the cluster.
3. Enter the question you want to investigate.
4. Run the task when needed, or configure a schedule.

For a recurring task:

1. Enter a five-field cron schedule.
2. Choose the timezone.
3. Enable the task.

Scope saves each run in your run history. AI tasks are read-only.

Schedules need a running local service on an awake computer. On macOS, closing
the app window leaves the service running. Quitting the app stops it. On
Windows, closing the window stops the app and service. External notifications
and automatic setup on a remote computer are not available.

For detailed setup, data locations, and feature limits, read README.md and
docs/running.md in your source checkout.