# Install with AI

Point your AI coding agent at iterateTo's Agent Skill and let it install and configure the widget for you.

iterateTo ships an **Agent Skill** — a single `SKILL.md` that any modern coding assistant can read (Claude Code, Codex / ChatGPT, Cursor, VS Code / Copilot, Gemini CLI, Windsurf, and more). Give your agent the skill and it detects your framework, drops in the embed, wires env, and records the setup in your `AGENTS.md` so future sessions know the widget is there.

## Point your agent at the skill

The install skill is hosted at `https://iterateto.com/skill.md`. Fetch it and follow the procedure, or add it to your repo with:

```bash
npx skills add https://iterateto.com/skill.md
```

## Or just run the CLI

The skill shells out to the same CLI you can run yourself — skills provide the context, the CLI does the work. `iterateto info --json` reads your project's real state so the agent doesn't guess; `init` writes the embed.

```bash
npx iterateto init --key pk_... --yes
```

## What the agent does

1. Runs `iterateto info --json` to read your actual framework and install state.
2. Confirms your project public key (`pk_...`) from the dashboard — it never hard-codes a key.
3. Runs `npx iterateto init --key <pk_> --yes` (or the manual embed it prints).
4. Wires the necessary env and verifies the widget config responds.
5. Appends a short iterateTo block to your `AGENTS.md` / `CLAUDE.md` recording where the keys live and how to reach the MCP queue.

## Machine-readable docs

Every docs page is available as raw Markdown — append `.md` to any docs URL, or use the copy button at the top of the page. Two site-wide indexes help agents discover the rest:

- [`/llms.txt`](/llms.txt) — a link map of the docs (the emerging convention).
- [`/llms-full.txt`](/llms-full.txt) — the full docs as a single Markdown file.
- [`/skill.md`](/skill.md) — the hosted install skill, served verbatim.