# IDE Setup

The fastest path for most IDEs is the [skills CLI](https://agentskills.io), which auto-installs the bundled `skills/aigateway/SKILL.md` into every detected agent:

```bash
npx skills add AEON-Project/aigateway -g -y
```

For IDEs the skills CLI doesn't cover natively, copy the matching template from `templates/` into your project.

## Cursor

Cursor reads `.cursor/rules/*.mdc` from the project root.

```bash
mkdir -p .cursor/rules
cp node_modules/@aeon-ai-pay/aigateway/templates/cursor/.cursor/rules/aigateway.mdc .cursor/rules/
```

If you installed `@aeon-ai-pay/aigateway` globally (`npm i -g`), substitute the `npm root -g` path. The `.mdc` file includes a `description:` line so Cursor can decide when to apply it.

## Windsurf

Windsurf reads `.windsurfrules` from the project root.

```bash
cp node_modules/@aeon-ai-pay/aigateway/templates/windsurf/.windsurfrules ./.windsurfrules
```

If you already have project-level Windsurf rules, append the contents of the template instead of overwriting.

## Cline / Roo Code

Both Cline and Roo Code read `.clinerules` from the project root.

```bash
cp node_modules/@aeon-ai-pay/aigateway/templates/cline/.clinerules ./.clinerules
```

## Codex / OpenAI Codex

Codex reads `AGENTS.md` from the project root (or nested folders).

```bash
cp node_modules/@aeon-ai-pay/aigateway/templates/codex/AGENTS.md ./AGENTS.md
```

If your repo already has an `AGENTS.md`, append the `aigateway` section rather than overwriting.

## Claude Code & 40+ Other Agents

For Claude Code, OpenClaw, Gemini CLI, GitHub Copilot, and 30+ others, the [skills CLI](https://agentskills.io) installs the full `SKILL.md` automatically. No manual copying needed.

## Verifying It Works

After installation, in your IDE chat say:

> Generate me an image of a cyberpunk fox.

The agent should propose running `aigateway wallet-init` (one-time, auto-creates a wallet), then `aigateway sb tools --category image` to pick a model, then `aigateway sb invoke --model <id> --inputs '{"prompt":"cyberpunk fox"}'`. If it doesn't, the rule file isn't being picked up — check that the file path matches what your IDE expects and that the IDE has been restarted.
