Redirector
Browse, search, and navigate URL redirects defined in YAML — directly from VS Code and Cursor.
Redirector reads redirect rules from your workspace, displays them in a tree view, and lets you jump to the exact line in the source file with a single click.
Features
- Tree view — explore redirect rules with destinations (
to) and source paths (from)
- Grouping — group redirects by the first URL segment (e.g.
account, cloud-servers)
- Search — filter by destination or source path
- Open at line — click any rule or path to open the YAML file at the correct line
- Auto-refresh — updates when the redirect file is saved
- Hide
/en redirects — optionally hide English redirect rules
Requirements
Open a workspace folder that contains a YAML file with redirects in the following structure:
app:
config:
redirects:
- to: "/account/"
from:
- "/old-account-path/"
- "/legacy/account/"
- to: "/cloud-servers/"
from:
- "/cloud/"
By default, Redirector looks for helm/values/common.yaml relative to the workspace root.
Getting Started
- Install the extension
- Open a project that contains your redirect YAML file
- Click the Redirector icon in the Activity Bar
- Expand groups and rules to explore redirects
Tree View Actions
| Button |
Action |
| Search |
Filter redirects by to or from path |
| Clear search |
Remove the active filter |
| Refresh |
Reload redirects from disk |
| Settings |
Open extension settings |
Click a destination (to) to jump to its line in the YAML file.
Click a source path (from) to jump to that specific entry.
Configuration
| Setting |
Default |
Description |
redirector.filePath |
helm/values/common.yaml |
Path to the redirect YAML file (relative to workspace root) |
redirector.groupRedirects |
true |
Group redirects by the first URL path segment |
redirector.hideEnRedirects |
false |
Hide rules whose destination starts with /en/ |
Example settings.json:
{
"redirector.filePath": "helm/values/common.yaml",
"redirector.groupRedirects": true,
"redirector.hideEnRedirects": false
}
Development
npm install
npm run watch
Press F5 to launch the Extension Development Host. To debug against another project, configure .vscode/launch.json to open the target workspace folder.
Build
npm run compile
npm run package
Package
npx @vscode/vsce package
License
MIT
