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

# Setup for Agents

> Paste one prompt into your coding agent and let it wire Glasswarp into your project.

Glasswarp is built to be set up **by an agent, for an agent**. Paste the prompt
below into your coding agent (Cursor, Claude Code, and similar). It reads the
public [`SKILL.md`](https://www.glasswarp.com/SKILL.md), inspects your project,
installs the SDK, and wires up the eyes-and-hands loop — pausing for the human
Windows-host step.

## The prompt

Copy this into your agent:

```text Setup for Agents theme={null}
Set up Glasswarp in this project.

Read https://www.glasswarp.com/SKILL.md and follow its setup instructions.

Goal: give this project's agent eyes and hands on a real Windows machine
through the Glasswarp API. Glasswarp supplies eyes and hands; this project
supplies the model and task logic.

Step 1 — Inspect and ask:
- Inspect this codebase's language, framework, runtime, package manager,
  dependency files, entry points, tests, agent code, and secrets conventions.
- Ask whether I want Glasswarp integrated here or a minimal Python quickstart.
- Python 3.9+ is the supported SDK. For a non-Python project, explain the choice
  between a small Python worker and direct REST; do not silently add a runtime.

Step 2 — Dependencies and key:
- Install glasswarp using the existing package manager (pip, uv, Poetry, or
  Pipenv) and update its dependency file.
- Use the optional grounding extra only for image/ROI helpers.
- If PyPI says glasswarp is unavailable, do not install a similarly named
  package. Ask for the approved SDK source/artifact.
- Ask me to create an API key at https://www.glasswarp.com/console -> API Keys.
  Store it as GLASSWARP_API_KEY using the existing secrets convention. Never
  print, commit, or hardcode it.

Step 3 — Human Windows setup:
- A real Windows host is required. Direct me to
  https://www.glasswarp.com/downloads to install the host agent.
- Then direct me to Console -> Rigs to pair it, confirm it is online, and enable
  per-rig API access.
- Pause and ask me to confirm an online, API-enabled rig exists. This is a
  normal owner-consent step; do not bypass it or request machine passwords.

Step 4 — Integrate:
- Match this project's conventions.
- Implement list_rigs -> create_session -> screenshot/observe -> native
  click/type -> end_session.
- Always end metered sessions in a finally block.
- Keep prompts and task decisions in customer code, separate from the
  Glasswarp transport adapter.

Step 5 — Verify:
- Run the integration in the project's real environment.
- Confirm an eligible rig, a successful session, a non-empty JPEG, a session
  visible in Console -> Sessions / Live View, and cleanup after failure.
- Run the relevant formatter, type checker, and tests.
- Diagnose and fix failures, then report dependencies installed, files changed,
  commands run, and checks passed.
```

## What the agent will do

<Steps>
  <Step title="Read the skill and inspect your project">
    It fetches [`SKILL.md`](https://www.glasswarp.com/SKILL.md) and detects your
    language, package manager, and conventions.
  </Step>

  <Step title="Install the SDK and set up the key">
    It adds `glasswarp` with your package manager and stores
    `GLASSWARP_API_KEY` via your existing secrets convention.
  </Step>

  <Step title="Pause for the human host step">
    It stops and asks you to install the [host agent](/get-started/install-host),
    pair the rig, and enable API access — a physical, owner-consent step it can't
    do for you.
  </Step>

  <Step title="Integrate and verify">
    It writes the integration in your style, runs it, and confirms a live
    session in the Console.
  </Step>
</Steps>

<Note>
  The one step no agent can skip: a human installs the host agent on a real
  Windows machine and enables API access. That owner consent is by design — see
  [Safety and consent](/concepts/safety-and-consent).
</Note>

Prefer to do it yourself? Follow the [Quickstart](/quickstart) instead.