LogicFalcon for Visual Studio Code & Compatible IDEs 🦅
Fast, precise engineering intelligence, deterministic code review, and automated fixes. Powered by AEGIS AI.
Key Capabilities (v0.2.0)
1. In-Editor Review & Instant Diagnostics
- Active File Review: Review any Python or TypeScript/JavaScript file directly (
⌘+Shift+P -> LogicFalcon: Review Active File).
- Unsaved Buffer Analysis: Analyzes live changes in dirty buffers in real-time before saving to disk.
- Precision Diagnostics: Pinpoints security flaws, AST code smells, and quality defects with exact 1-indexed line and column ranges in the editor and Problems panel.
2. Advanced Review Dashboard
- Multi-Mode Grouping: Group findings in the sidebar by:
- Severity:
CRITICAL, ERROR, WARNING, INFO.
- File: Chronological or alphabetical file structure.
- Rule ID: Focus on specific rules across the codebase (e.g.
SEC-001, QUAL-002).
- Interactive Search & Category Filters: Filter findings by text search or categories (
SECURITY, QUALITY, RELIABILITY, PERFORMANCE).
- Workspace Dashboard Webview (
LogicFalcon: Open Review Dashboard): Displays overall repository health scores (0-100%), severity breakdowns, affected file metrics, and export actions for Markdown and SARIF reports.
3. Safe Quick Fixes & Diff Previews
- Native Inline Diff Previews: Hovering over a QuickFix CodeAction immediately reveals VS Code's native inline diff.
- Side-by-Side Unified Diff (
LogicFalcon: Preview Fix Diff (Side-by-Side)): Inspect changes in a split editor comparison before applying.
- Stale Code Protection: Validates that the file has not been modified externally since the review was generated.
- Automatic Rollback Backups: Every applied fix automatically generates a
.orig backup file.
- One-Click Rollback (
LogicFalcon: Rollback Last Remediation): Instantly restore files to their pre-fix state.
4. Multi-IDE Architecture & Cursor Integration
- Cursor Compatibility: Full support for Cursor. Run
LogicFalcon: Generate .cursorrules for Cursor AI to automatically scaffold workspace rules that guide Cursor's AI Composer to respect LogicFalcon AST constraints.
- Google Antigravity: Compatible with Antigravity IDE and integrated with the LogicFalcon Antigravity agent skill and MCP server.
Requirements
- Python >= 3.12
logicfalcon installed in your virtual environment:
pip install -e .
- Optional:
ruff for enhanced external linter checks.
Extension Commands
| Command |
Title |
Description |
logicfalcon.reviewActiveFile |
Review Active File |
Runs deterministic AST review on the current editor buffer. |
logicfalcon.reviewWorkspace |
Review Workspace |
Scans all supported files across the workspace. |
logicfalcon.openDashboard |
Open Review Dashboard |
Opens the interactive workspace review dashboard panel. |
logicfalcon.previewFixDiff |
Preview Fix Diff (Side-by-Side) |
Opens side-by-side split diff for an automated fix. |
logicfalcon.rollbackFix |
Rollback Last Remediation |
Restores the file from .orig backup. |
logicfalcon.showDoctor |
Show Capability Doctor |
Inspects host IDE, Python runtime, AST analyzer, and tools. |
logicfalcon.setGroupingMode |
Change Findings Grouping Mode |
Switch between Severity, File, and Rule grouping. |
logicfalcon.filterFindings |
Filter Findings |
Filter sidebar findings by query text or category. |
logicfalcon.clearFindings |
Clear All Findings |
Clears findings and diagnostics. |
logicfalcon.refreshFindings |
Refresh Findings |
Re-executes review for active file or workspace. |
logicfalcon.generateCursorRules |
Generate .cursorrules for Cursor AI |
Scaffolds .cursorrules to instruct Cursor AI Composer. |
logicfalcon.exportReport |
Export Review Report |
Exports findings as Markdown (.md) or SARIF (.sarif). |
Extension Settings
| Setting |
Type |
Default |
Description |
logicfalcon.pythonPath |
string |
"" |
Path to Python interpreter (auto-detects virtualenvs by default). |
logicfalcon.cliPath |
string |
"" |
Path to logicfalcon CLI executable (optional). |
logicfalcon.autoReviewOnSave |
boolean |
true |
Automatically review supported files on save. |
logicfalcon.enableTools |
boolean |
true |
Enable external linters (Ruff) if available. |
logicfalcon.enableAi |
boolean |
false |
Enable optional AI-assisted review analysis. |
logicfalcon.severityThreshold |
enum |
"WARNING" |
Minimum severity displayed (INFO, WARNING, ERROR, CRITICAL). |
logicfalcon.groupingMode |
enum |
"severity" |
Sidebar grouping mode ("severity", "file", "rule"). |
logicfalcon.fixSafetyLevel |
enum |
"preview-first" |
Safety level when applying fixes ("preview-first", "prompt", "strict"). |
logicfalcon.perFileTimeout |
number |
15 |
Timeout per file in seconds. |
logicfalcon.maxWorkspaceFiles |
number |
500 |
Max files inspected in workspace scans. |
logicfalcon.ignorePatterns |
array |
[...] |
Glob patterns to ignore during scans. |
logicfalcon.logVerbosity |
enum |
"info" |
Logging verbosity ("debug", "info", "warning", "error"). |
Supported IDEs & Installation
Visual Studio Code
Install directly from the Visual Studio Marketplace or via VSIX:
code --install-extension logicfalcon-vscode-0.2.0.vsix
Cursor
Cursor uses standard VS Code extensions:
cursor --install-extension logicfalcon-vscode-0.2.0.vsix
Then run LogicFalcon: Generate .cursorrules for Cursor AI to synchronize Cursor Composer with LogicFalcon AST rules.
Google Antigravity
Install the extension in Google Antigravity IDE:
# In Antigravity terminal:
code --install-extension logicfalcon-vscode-0.2.0.vsix
The extension automatically detects Antigravity and integrates with the .agents/skills/logicfalcon/ intelligence workflows.
License
Apache-2.0
| |
