vClaw is a high-performance Visual Studio Code extension designed to master code navigation through structural intelligence. By using advanced indentation analysis and scope detection, it allows developers to "grab" and visualize complex code blocks instantly, increasing refactoring speed and structural awareness.
vClaw doesn't just select text; it understands the hierarchy of your source code:
- Multi-Language Intelligence: Seamlessly analyzes indentation for Python/YAML and bracket-depth for C-style languages (JS, TS, C++, Java).
- Visual Feedback: Uses non-intrusive, high-visibility decorations to highlight the "captured" scope without losing your cursor position.
- Root-Level Detection: Automatically identifies the global boundaries (HTML tags, Class definitions) to grasp the entire architectural unit.
Designed to handle everything from simple scripts to massive enterprise files:
- Indent-Based Logic: Perfect for clean-up in YAML, Python, and Slim files where braces are absent.
- Bracket-Aware Parsing: Precision-tracking for curly braces
{}to ensure no logic is left behind. - Empty Line Handling: Intelligently skips whitespace while maintaining the integrity of the selection.
-
Snap (Inner Scope) -
Alt + XInstantly captures the immediate logic block or the current line. Think of it as opening a single drawer in a cabinet. -
Grip (Parent Scope) -
Alt + CExpands the "claw" to the containing function or parent block. Selecting the entire room instead of just a drawer. -
Clench (Global Root) -
Alt + VGrasps the ultimate parent structure (e.g., the entire<html>tag orclassbody). Capturing the whole building in one click. -
Release (Clear) -
Alt + BInstantly clears all active highlights and resets the pincer.
- Download the
vclaw-0.1.0.vsixfile from the releases section. - Open VS Code and go to the Extensions view (
Ctrl+Shift+X). - Click the "..." (three dots) in the top right corner.
- Select Install from VSIX... and choose the downloaded file.
git clone [https://github.com/erogluyusuf/vClaw.git](https://github.com/erogluyusuf/vClaw.git)
cd vClaw
npm install
npm run compilevClaw can be integrated into your existing workflow:
| Feature | Trigger | Description |
|---|---|---|
| Snap | Context Menu / Keybind | Captures Inner Scope |
| Grip | Context Menu / Keybind | Captures Parent Scope |
| Clench | Context Menu / Keybind | Captures Root Scope |
| Release | Context Menu / Keybind | Clears active decorations |
Pull requests are welcome. For major changes, please open an issue first to discuss what you plan to modify.
Help us make code navigation even more intuitive!
Distributed under the MIT License. See LICENSE for more information.
Maintained by: Yusuf Eroğlu
Code hierarchy, captured.