YAML Handler Links
Ctrl+click on handler paths in YAML files to navigate directly to the source file.
Built for Serverless Framework projects, but works with any YAML file that references source paths.
Features
- Ctrl+Click navigation — click on any
handler: value in a YAML file to open the referenced source file
- Smart path resolution — automatically resolves
src/path/to/file.handler by stripping the function name and trying multiple file extensions (.ts, .js, .mjs, .cjs)
- Index file support — resolves paths pointing to directories with
index.ts / index.js
- Configurable keys — not limited to
handler:, you can add any YAML key (e.g., source, path)
How it works
Given a serverless.yml like:
functions:
syncOrders:
handler: src/orders/infrastructure/presentation/syncOrders.handler
timeout: 600
events:
- schedule: rate(5 minutes)
The extension detects handler: lines, resolves src/orders/infrastructure/presentation/syncOrders to an actual file (e.g., syncOrders.ts), and makes it a clickable link. Ctrl+Click opens the file.
Configuration
| Setting |
Default |
Description |
yamlHandlerLinks.handlerKeys |
["handler"] |
YAML keys whose values are treated as file paths |
yamlHandlerLinks.extensions |
[".ts", ".js", ".mjs", ".cjs"] |
File extensions to try when resolving paths |
Example: adding custom keys
{
"yamlHandlerLinks.handlerKeys": ["handler", "source", "entryPoint"]
}
Installation
From Marketplace
Search for "YAML Handler Links" in the Extensions tab of VS Code or Cursor.
From source
git clone https://github.com/erevecov/yaml-handler-links.git
cd yaml-handler-links
npm install
npm run compile
# Then press F5 in VS Code to launch the Extension Development Host
Compatibility
- VS Code 1.80+
- Cursor
- Any YAML/YML file
License
MIT
