A11y Resolver

Preview/Beta: This extension is under active development, and the experience may change frequently.

A11y Resolver helps you find and fix accessibility issues directly inside your editor.

What it does

• Scans your code for common accessibility issues such as missing labels, low contrast, and keyboard traps.
• Explains issues clearly in plain language so you understand what needs attention.
• Helps you apply fixes through a conversational chat interface — describe what you need or let the agent propose changes.
• Can run tasks in its internal browser so the app can navigate and interact with pages it controls when needed.
• Keeps your session history so you can continue where you left off.

Getting started

1. Install the extension in VS Code or Windsurf.
2. Open the A11y Resolver Beta panel from the activity bar.
3. Enter your OpenRouter API key when prompted.
4. Select the agent that best fits your task.
5. Start a conversation or run the issue scanner to see what needs attention.

OpenRouter API key setup

This extension uses OpenRouter to access the models that power its resolver agents.

How to get your OpenRouter API key

1. Create or sign in to your account at https://openrouter.ai.
2. Add credits or enable billing in your OpenRouter account, if needed.
3. Open the Keys section in the OpenRouter dashboard.
4. Create a new API key.
5. Copy the key and keep it secure.

Your key will look similar to:

sk-or-v1-...

How to use it in the extension

1. Open the A11y Resolver Beta panel.
2. Paste your OpenRouter API key when prompted.
3. The key is stored locally and securely in VS Code's secret storage.

Agents and model costs

A11y Resolver currently offers two agent options. Both use OpenRouter, but each one uses a different model.

Issues Resolver (Fast)

• Best for: everyday accessibility fixes, faster iteration, and lower cost
• Model: openai/gpt-5.4-mini

Issue Resolver Expert

• Best for: deeper analysis, stubborn issues, and more complex debugging or remediation
• Model: openai/gpt-5.4

Which agent costs less?

• Issues Resolver (Fast) is generally the lower-cost option.
• Issue Resolver Expert usually costs more, but it can be the better choice for complex tasks.

Because OpenRouter pricing can change over time, this README does not hardcode token prices.

To estimate current cost accurately, check the pricing pages for these exact models in OpenRouter:

• openai/gpt-5.4-mini
• openai/gpt-5.4

A simple rule of thumb is:

• Start with Fast for most tasks.
• Switch to Expert when you need deeper reasoning or when an issue is harder to resolve.

Tips for controlling cost

Your OpenRouter usage depends on:

• the agent you choose,
• the model behind that agent,
• the size of your prompts and attached context,
• and how many follow-up turns are needed.

If you want to keep costs down:

• start with Issues Resolver (Fast),
• keep prompts focused,
• avoid unnecessary large attachments,
• and switch to Issue Resolver Expert only when the task needs deeper analysis.

Notes

• You need a valid OpenRouter API key to use the AI chat features.
• Some tasks can run in the extension's internal browser. To use that capability, Google Chrome must be installed on your machine.
• Billing and model availability are managed through your OpenRouter account.
• This extension is currently in Preview/Beta, so the experience and available agents may evolve.