The complete AIR reference

Install AIR from the VS Code Marketplace, or search "AIR — AI Intent Runtime" inside the Extensions panel. No account, license key, or workspace configuration is required to start recording.

AIR requires VS Code 1.85 or later and a Chromium-compatible environment for the recording browser, which AIR manages automatically.

AIR adds three controls to the bottom Status Bar of VS Code:

• AIR Start — opens a recording browser and begins capturing interactions.
• AIR Stop — ends the active recording and saves the session locally.
• AIR History — opens the panel listing every past session.

These replace the old Command Palette workflow entirely — there is nothing to type or remember.

The Session History panel lists every recording with its status (Recorded, Processing, or Ready), timestamp, and a one-click Copy Session ID action. From here you can refresh the list, delete old sessions, or reopen a session's summary.

While recording, AIR captures:

• Clicks, keystrokes, and form inputs
• Navigation and route changes
• DOM structure and semantic attributes (roles, labels, test IDs)
• Timing and network-idle state, so generated waits reflect real page behavior

All of this is written to a local session file — nothing leaves your machine during recording.

Once you have a Session ID, paste it into a prompt to any supported assistant — GitHub Copilot, Claude Code, Cursor, Gemini, Codex, Windsurf, Continue, Cline, or Roo Code. The assistant reads the session's context and generates automation code directly into your project.

See the AI Prompt Examples page for ready-to-use prompts across frameworks and tasks.

AIR exposes an MCP server so any MCP-compatible AI assistant can query session data directly, rather than relying on copy-pasted context. This gives the assistant structured access to locators, DOM snapshots, and interaction sequences.

Full setup steps live in the MCP Setup Guide.

AIR Start doesn't open a browser

Reload the VS Code window and confirm no other AIR recording is already active — only one session can record at a time.

A session isn't appearing in AIR History

Click the refresh control in the History panel. If the session still doesn't appear, confirm AIR Stop was clicked to finalize it — an unclosed session isn't saved.

My AI assistant can't find a Session ID

Confirm the ID was copied from AIR History (not typed from memory), and that the assistant has MCP access configured if you're using MCP integration rather than manual paste.

See the full FAQ on the homepage, covering data privacy, supported frameworks, and exporting sessions.