Cyclopt for Visual Studio Code

Professional code quality analysis powered by Cyclopt. Get instant feedback on code metrics, security vulnerabilities, style violations, code duplication, and dependency issues.

Quick Start

1. Install the Extension

• Open VS Code Extensions (Ctrl+Shift+X / Cmd+Shift+X)
• Search for "Cyclopt"
• Click Install

2. Set Your API Token

1. Get your token from Cyclopt Dashboard
2. Open Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
3. Run Cyclopt: Set API Token
4. Paste your token

3. Run Your First Analysis

• Keyboard: Ctrl+Shift+A (Windows/Linux) or Cmd+Shift+A (Mac)
• Command Palette: Cyclopt: Analyze Current File
• Editor Menu: Click the play button in the top-right corner

Results appear in three places:

• Cyclopt Sidebar - Click the Cyclopt icon in the Activity Bar
• Problems Panel - Ctrl+Shift+M / Cmd+Shift+M
• Editor - Inline highlights on affected lines

Features at a Glance

Code Analysis

Multiple Analyzers - Run comprehensive checks on your code:

• Metrics - Complexity, maintainability, lines of code
• Violations - Code style, anti-patterns, best practices
• SAST - Security vulnerabilities, injection flaws
• Duplication - Duplicated and similar code blocks
• Vulnerabilities - Known CVEs in dependencies

Automatic Analysis - Optional triggers for seamless workflow:

• Analyze on Save - Run analysis every time you save
• AI Detection - Auto-analyze when Copilot/AI tools generate code

Smart Filtering - Focus on what matters:

• Filter by severity (critical, high, major, minor)
• Quick filters: critical/high only, critical/high/major, all
• Hide noise, fix critical issues first

Results & Insights

Live Status Tracking - Always know the state of your code:

• Real-time progress with elapsed time
• Timestamp of last analysis
• Previous results visible during new analysis

Editor Safety - Prevents conflicts during analysis:

• Editor freezes during manual analysis
• Stays editable during AI-triggered analysis
• Visual lock indicator in status bar

Inline Decorations - Issues highlighted directly in code:

• Color-coded by severity (red, orange, blue)
• Hover for details
• Auto-tracks as you edit

AI Integration

Copy for AI Assistance - Right-click any issue to:

• Copy Issue Info - Get detailed information
• Create AI Prompt - Generate ready-to-use fix prompt with code context

Perfect for GitHub Copilot Chat, ChatGPT, Claude, or any AI assistant.

Copilot Instructions - Auto-generate .github/copilot-instructions.md:

• Teaches Copilot about Cyclopt
• Suggests commands for quality checks
• Integrates analysis into AI workflow

Quality Gates

Pre-Commit Hook - Block commits with critical issues:

• Install directly from VS Code
• Analyzes staged files before commit
• Blocks high-priority issues
• Results auto-load into sidebar

Export Results - Share findings and track progress:

• JSON, CSV, or Markdown formats
• Complete issue details
• Statistics and summaries

Smart Notifications

Auto-Dismiss - Simple confirmations disappear after 3 seconds Persistent - Important messages stay until dismissed Status Bar - Transient messages appear briefly, then vanish

Settings

Access settings in two ways:

1. Visual Panel: Command Palette → Cyclopt: Open Settings
2. VS Code Settings: Ctrl+, → Search "Cyclopt"

Key Settings

Commands

Access all commands via Command Palette (Ctrl+Shift+P / Cmd+Shift+P):

Analysis

• Cyclopt: Analyze Current File - Analyze active file
• Cyclopt: Analyze Selected Files - Analyze selected files/folders
• Cyclopt: Select Analyzers & Analyze - Choose analyzers to run
• Cyclopt: Clear Results - Clear all findings

Filtering

• Cyclopt: Show Critical and High Only - Display only critical and high severity
• Cyclopt: Show Critical, High, and Major - Critical, high, and major severity
• Cyclopt: Show All Severities - Show everything

Results

• Cyclopt: Export Analysis Results - Export to JSON/CSV/Markdown

Configuration

• Cyclopt: Open Settings - Visual settings panel
• Cyclopt: Set API Token - Configure API token
• Cyclopt: Generate Copilot Instructions - Create AI instructions

Git Hook

• Cyclopt: Install Pre-Commit Hook - Install git hook
• Cyclopt: Uninstall Pre-Commit Hook - Remove git hook
• Cyclopt: Activate Pre-Commit Hook - Enable hook
• Cyclopt: Deactivate Pre-Commit Hook - Disable hook

Supported Languages

Analysis: JavaScript, TypeScript, Python, Java, C#, PHP, Dart

Dependency Scanning: package.json, requirements.txt, pom.xml, build.gradle, pubspec.yaml, composer.json, and more

Keyboard Shortcuts

Learn More

• Full Documentation: See INSTRUCTIONS_AND_FEATURES.md for detailed guides and examples
• API Dashboard: https://app.cyclopt.com
• Support: https://docs.cyclopt.com

License

See LICENSE file for details.