Helix AI

An intelligent VS Code extension that automatically manages project-specific coding rules for Cursor AI and tracks AI-generated code telemetry, ensuring consistent development standards and providing insights into AI-assisted development patterns.

Features

Automatic Rule Management

• Repo Detection: Automatically detects Git repositories in your workspace
• Smart Rule Syncing: Deploys appropriate rules based on repository name or project dependencies
• Real-time Updates: Syncs rules on startup, workspace changes, and manual commands

Rule Deployment Logic

1. Repository Match: If your repo matches a configured repository name, deploys both repo-specific and common rules
2. Dependency Fallback: If no repo match but @marmeto_engineering/anthers-components is in dependencies, deploys common rules only
3. Cleanup: Removes stale helix rules when no conditions are met

File Management

• Syncs rules to .cursor/rules/ directory as .mdc files
• Enforces YAML frontmatter with alwaysApply: true
• Supports multiple workspace folders simultaneously
• Automatic cleanup of outdated rule files

AI Code Telemetry Tracking

• Automatic Detection: Tracks AI-generated code vs human-written code in real-time
• File-Level Metrics: Calculates percentage of AI-generated code per file
• Commit Aggregation: Aggregates telemetry data for staged files before commits
• Git Integration: Automatically tracks staged files and commit hashes
• Data Validation: Recalibrates telemetry against git diffs to ensure accuracy
• Google Sheets Upload: Automatically uploads aggregated commit data to Google Sheets via post-commit hook
• Operation Tracking: Tracks file operations (create, update, delete, rename) with undo/redo support
• Smart Filtering: Filters out formatting-only changes and paste operations

Requirements

• VS Code or Cursor editor
• Git repository (for automatic repo detection and telemetry tracking)
• Node.js project with package.json (for dependency detection)

Extension Settings

This extension contributes the following settings:

Commands

• helix-ai.syncRules: Manual command to sync project rules

Automatic Activation

• Automatic activation on startup and workspace folder changes
• Automatic rule syncing on workspace folder changes

Usage

Rule Management

1. Automatic: Rules sync automatically when you:

   • Start VS Code/Cursor
   • Open a new workspace folder
   • Switch between workspace folders

2. Manual: Use the command palette:

   • Press Ctrl+Shift+P (or Cmd+Shift+P on macOS)
   • Type "Helix AI: Sync Project Rules"
   • Press Enter

Telemetry Tracking

Telemetry tracking is automatic and requires no user intervention:

1. Automatic Tracking: The extension automatically tracks all document changes and detects AI-generated code
2. Git Integration: When you stage files, telemetry is automatically aggregated and validated
3. Commit Upload: After committing, a git post-commit hook automatically uploads aggregated data to Google Sheets

How It Works

Rule Management Flow

1. Extension detects Git repositories in workspace folders
2. Checks repository name against configured rules
3. Checks package.json for @marmeto_engineering/anthers-components dependency
4. Deploys appropriate rules to .cursor/rules/ directory
5. Cleans up stale rules when conditions no longer match

Telemetry Tracking Flow

1. Document Changes: Extension monitors all text document changes
2. AI Detection: Uses multiple detection methods (telemetry blocks, AI detection libraries, heuristics) to identify AI-generated code
3. Operation Tracking: Tracks each change as an operation with line ranges, timestamps, and confidence scores
4. Normalization: Merges overlapping operations and normalizes conflicts
5. File Metrics: Calculates file-level AI percentage and aggregates operations
6. Git Stage: When files are staged, telemetry is recalibrated against git diffs
7. Commit: Post-commit hook uploads aggregated data to Google Sheets

Release Notes

See CHANGE LOG for detailed release notes.

Enjoy intelligent rule management and AI code tracking with Helix AI!