Stop switching to external API clients. Test and debug your Express and NestJS routes directly from your editor with a single click.
Easy Run turns your VS Code into a powerful API testing playground, automatically detecting your routes and providing a smooth, Postman-like experience without leaving your code.
- Auto-Scanner: Instantly finds routes in Express and NestJS files.
- NestJS Power User: Detects
setGlobalPrefix, resolves dynamic variables in prefixes, and handles Monorepos effortlessly. - CodeLens Integration: A "Run" button appears directly above your route definitions.
- Postman-style Panel: Full-featured UI with tabs for Params, Auth, Body, and Headers.
- Auth Support: Built-in support for Bearer Tokens, Basic Auth, and API Keys.
- Smart Formats: Syntax highlighting for JSON responses and clean status/time badges.
- Binary-Safe File Uploads: Deep support for
multipart/form-data. Upload images, PDFs, and more directly from the UI. - Path Param Pre-filling: Automatically detects
:idor:userIdin your routes and creates input fields for them. - Request Cancellation: Stop long-running requests instantly with the integrated Cancel button.
- Multi-Project Support: Automatically identifies different projects in your workspace and isolates their configurations.
- Port Autodiscovery: Scans your
.envfiles to find the correct local port for each project. - Existing Server Mode: Toggle between spinning up a temporary test server or hitting your already running application.
- Install the extension.
- Open any file containing Express or NestJS routes.
- Click "Run" above a route definition.
- Configure your request in the popup panel and hit Send.
Easy Run is designed to work out of the box, but you can fine-tune it:
| Setting | Description | Default |
|---|---|---|
apiRouteTester.enableDetection |
Enable/Disable automatic route scanning. | true |
apiRouteTester.useExistingServer |
Use your running server instead of a temp one. | false |
apiRouteTester.existingServerUrl |
The base URL for your running server. | http://localhost:3000 |
apiRouteTester.manualGlobalPrefix |
Override detected global prefixes (e.g. /api/v1). |
"" |
- Local Only: Your data never leaves your machine. All requests are sent from your local environment.
- Privacy First: Easy Run does not collect any user information, source code, or request data. Nothing is sent to external servers or used for telemetry.
- Strict CSP: The Request UI uses a strict Content Security Policy and nonces to prevent XSS.
- Path Hardening: Built-in protection against path-based script injection.
- Standard FS Access: Only accesses files in your workspace or those you explicitly select for upload.
Developed with ❤️ by Yusuf