MARY VS Code Extension Features

This document provides a comprehensive overview of the features available in the MARY VS Code Extension.

Command Palette Integration

All MARY functionality is accessible through the VS Code Command Palette (Ctrl+Shift+P / ⌘+Shift+P):

• MARY: New Project - Create a new MARY project
• MARY: Open Project - Open an existing MARY project
• MARY: Run Workflow - Execute a workflow in the current project
• MARY: Deploy - Deploy your application

Project Explorer

The MARY Project Explorer provides a dedicated view for managing your MARY projects:

• View project structure and dependencies
• Access project-specific commands
• Monitor project status
• Navigate between project components

Code Intelligence

The extension enhances your coding experience with:

• Smart Completions - Context-aware code suggestions
• Inline Documentation - Documentation tooltips for MARY APIs
• Error Detection - Real-time validation of MARY configurations
• Quick Fixes - One-click solutions for common issues

Workflow Editor

Design and manage workflows directly in your editor:

• Visual workflow editor for creating automation flows
• Trigger workflows from within the editor
• View execution results and logs
• Debug workflows with breakpoints and step-through execution

Snippets and Templates

Speed up development with pre-built code snippets and templates:

• Project scaffolding templates
• Common code patterns
• Configuration snippets
• Workflow templates

Settings Sync

Your MARY settings and preferences sync across devices:

• Project configurations
• User preferences
• Custom templates
• Workflow definitions

Editor Integration Features

The extension integrates with editor features like:

• Custom Views - Dedicated panels for MARY functionality
• Status Bar - Quick access to common actions
• Activity Bar - MARY icon for accessing all functionality
• Editor Decorations - Visual cues for MARY-related code

Terminal Integration

Control the MARY CLI directly from the integrated terminal:

• Run CLI commands with auto-completion
• View command output in the editor
• Access command history
• Save frequently used commands as tasks

Extension Settings

Customize the extension through settings:

{
  "mary.enableAutomaticUpdates": true,
  "mary.showWelcomeOnStartup": true,
  "mary.defaultProjectLocation": "${workspaceFolder}",
  "mary.logLevel": "info"
}

Keyboard Shortcuts

Customize keyboard shortcuts for frequently used MARY commands:

Command	Default Shortcut
MARY: New Project	Ctrl+Alt+N / ⌘+Option+N
MARY: Run Workflow	Ctrl+Alt+R / ⌘+Option+R
MARY: Open Explorer	Ctrl+Alt+M / ⌘+Option+M