OctAPI – API Route Explorer for VS Code

Effortlessly visualize and navigate your API routes – directly in VS Code.

Demo

Features

OctAPI provides a seamless way to explore and manage your API routes within Visual Studio Code. Here are its key features:

• Smart Route Detection – Scans all files within a user-defined directory to identify API routes.
• Framework Support – Works with Express, NestJS, Koa, Flask, and FastAPI.
• Smart File Watching & Caching – Automatically detects file changes and updates routes in real time.
• Jump to Code – Clicking a route takes you directly to the exact line where it's defined.
• Quick Copy with Prefixing – Hover over a route to reveal a copy button, with an option to specify a route prefix.
• Flexible Organization – Toggle between grouping by basepath or HTTP method.
• Visual Enhancements – Routes feature distinct icons and colors for improved clarity and organization.
• Native Sidebar Integration – View all detected routes directly in VS Code’s sidebar.
• Favorite Routes Management – Star and persistently favorite frequently used routes, with an option to clear all favorites via a dedicated command.
• Postman Export Command – Export API routes as an importable Postman JSON collection, complete with method, full path, and path parameters, organized in appropriate subfolders.

🛠 Report Issues & Give Feedback

Have a suggestion or found a bug? Let us know!
👉 Submit feedback here

OctAPI is constantly evolving. If your preferred framework isn't supported yet, open a new issue on GitHub and let us know!

Requirements

• Visual Studio Code: Ensure you have VS Code installed.
• Supported Frameworks: Express.js, NestJS, Koa, Flask, and FastAPI.

Extension Settings

This extension contributes the following settings:

• octapi.path: Define custom search paths for route detection.
• octapi.framework: Set the framework for route detection.
• octapi.urlPrefix: Specify a prefix to prepend when copying routes.

Installation

You can install OctAPI from the following sources:

Microsoft Marketplace

1. Visit the OctAPI extension page on the Microsoft Marketplace.
2. Click the Install button.
3. Follow the prompts to install the extension in VS Code.

Open VSX

1. Visit the OctAPI extension page on Open VSX.
2. Click the Install button.
3. Follow the prompts to install the extension.

Manual Installation

1. Download the latest .vsix package from the Releases page.
2. Open VS Code and navigate to Extensions (Ctrl+Shift+X).
3. Click the ... menu and select Install from VSIX....
4. Select the downloaded file and install it.
5. Reload VS Code if needed.

Known Issues

• More language support is still in progress.
• Large codebases may experience slower scanning times.

Release Notes

v0.5.3 - 2025-03-23

• Fixes in Grouping & Copying: Resolved an issue where grouping by basepath displayed the full path instead of just the path. Copying a route now correctly includes the full path.

v0.5.2 - 2025-03-21

• Optimized File Scanning: Improved performance by scanning only relevant files, reducing unnecessary processing.

v0.5.1 - 2025-03-15

• Fixed infinite loading when no routes were detected.
• Resolved an issue where configuration changes weren't applying properly.

v0.5.0 - 2025-03-14

• File Watcher with Caching – OctAPI now detects file changes and updates routes automatically, significantly improving performance.
• Automated File Retrieval for Frameworks – A new utility streamlines file collection based on framework-specific structures, enhancing compatibility.
• Improved File Filtering and Directory Handling – Directories are now processed in batches to prevent stack overflows.
• Updated Welcome Message – Encourages users to report unsupported frameworks via a dedicated GitHub issue template.

v0.4.1 - 2025-03-10

• Postman Export Grouping: Routes are now grouped into subfolders based on their basepath instead of all being placed in the root folder, making API organization clearer.

Contributing

Contributions are welcome! Here's how you can help:

1. Fork the repo.
2. Create a feature branch (git checkout -b feature-name).
3. Commit changes (git commit -m "Describe feature").
4. Push to your branch (git push origin feature-name).
5. Open a Pull Request.

License

Licensed under the Apache 2.0 License. See LICENSE for details.

Privacy Policy

OctAPI runs entirely locally—no data collection, tracking, or telemetry. Learn more.

Contact

• Author: Hasbi Sabah
• Email: sabahhasbi00@gmail.com
• GitHub: Hasbi-sabah

🚀 OctAPI – Stop searching, start coding.