Guide My AI Extension

A VS Code extension that connects to guidemyai.tech to sync AI coding assistant profiles, including custom rules and MCP (Model Context Protocol) servers, directly into your development environment.

Overview

Guide My AI Extension bridges the gap between your central registry and your local development environment. Configure your AI assistant rules and MCP servers on guidemyai.tech, assign them to profiles, then seamlessly sync them to any IDE with a single command.

Features

• 🔄 One-Click Profile Sync: Select and sync AI profiles from your guidemyai.tech account
• 📝 Custom AI Rules: Automatically writes AI assistant rules to your project's .cursorrules file
• 🔌 MCP Server Integration: Configures Model Context Protocol servers in your IDE settings
• 🎯 Multi-Profile Support: Switch between different AI profiles for different projects or contexts
• 🛡️ Works Across IDEs: Supports VS Code, Cursor, Antigravity, and other compatible editors

Installation

From VS Code Marketplace

1. Open VS Code/Cursor
2. Press Cmd+Shift+X (Mac) or Ctrl+Shift+X (Windows/Linux) to open Extensions
3. Search for "Guide My AI"
4. Click Install

From VSIX File

1. Download the latest .vsix file from the releases page
2. Open VS Code/Cursor
3. Press Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux)
4. Type "Extensions: Install from VSIX..."
5. Select the downloaded .vsix file

Usage

First Time Setup

1. Open Command Palette

   • Mac: Cmd+Shift+P
   • Windows/Linux: Ctrl+Shift+P

2. Select Profile Command

   • Type and select: Guide My AI: Select Profile

3. Authenticate

   • The extension will prompt you to authenticate with guidemyai.tech
   • Follow the OAuth flow in your browser
   • Once authenticated, you'll be automatically redirected back to your IDE

4. Choose Your Profile

   • A quick pick menu will display all your available profiles
   • Select the profile you want to use for the current project

What Happens When You Select a Profile?

The extension automatically:

• Creates/updates a .cursorrules file in your project root with your AI assistant rules
• Configures MCP servers in your IDE settings for the selected profile
• Stores your authentication token securely for future use

Switching Profiles

Simply run the Guide My AI: Select Profile command again to switch to a different profile. The extension will overwrite the existing configuration with the new profile's settings.

Configuration

Profile Management

All profile management is done through guidemyai.tech. You can:

• Create new profiles
• Edit existing profiles
• Configure custom AI rules
• Set up MCP servers
• Organize profiles by project type or use case

File Locations

• AI Rules: Written to .cursorrules in your project root
• MCP Settings: Stored in your IDE's user or workspace settings (depending on IDE)
• Auth Token: Securely stored in VS Code's Secret Storage API

Commands

The extension provides several commands to help you manage AI profiles, rules, and MCP servers:

Your Content Commands

Community Content Commands

Command Details

Select Profile

Select and sync a complete profile from your guidemyai.tech account, including all associated rules and MCP servers.

Steps:

1. Open Command Palette (Cmd+Shift+P / Ctrl+Shift+P)
2. Type and select Guide My AI: Select Profile
3. Authenticate if prompted
4. Choose a profile from your collection
5. The profile's rules and MCPs are automatically synced to your project

Select Rules

Pick and choose individual rules from your personal collection without selecting an entire profile.

Steps:

1. Open Command Palette
2. Type and select Guide My AI: Select Rules
3. Authenticate if prompted
4. Select one or more rules (multi-select supported)
5. Selected rules are written to your project

Select MCPs

Pick and choose individual MCP servers from your personal collection without selecting an entire profile.

Steps:

1. Open Command Palette
2. Type and select Guide My AI: Select MCPs
3. Authenticate if prompted
4. Select one or more MCP servers (multi-select supported)
5. Selected MCPs are configured in your IDE

Browse Community Profiles

Explore profiles created by other users in the Guide My AI community.

Steps:

1. Open Command Palette
2. Type and select Guide My AI: Browse Community Profiles
3. Authenticate if prompted
4. Enter a username to browse
5. View and select from their public profiles
6. The selected profile is synced to your project

Pull Community Profile

Directly pull a specific profile if you know the exact username and profile slug.

Steps:

1. Open Command Palette
2. Type and select Guide My AI: Pull Community Profile
3. Authenticate if prompted
4. Enter the profile path in format: {username}/profiles/{profile-slug}
   • Example: sally-codes/profiles/node-testing
5. The profile is immediately synced to your project

Pull Community Rule

Directly pull a specific rule from another user.

Steps:

1. Open Command Palette
2. Type and select Guide My AI: Pull Community Rule
3. Authenticate if prompted
4. Enter the rule path in format: {username}/rules/{rule-slug}
   • Example: sally-codes/rules/node-testing-best-practices
5. The rule is immediately written to your project

Pull Community MCP

Directly pull a specific MCP server configuration from another user.

Steps:

1. Open Command Palette
2. Type and select Guide My AI: Pull Community MCP
3. Authenticate if prompted
4. Enter the MCP path in format: {username}/mcps/{mcp-slug}
   • Example: sally-codes/mcps/github-integration
5. The MCP is immediately configured in your IDE

Requirements

• VS Code 1.105.0 or higher (or compatible Cursor version)
• Active internet connection for initial authentication and profile syncing
• Account on guidemyai.tech

Privacy & Security

• Authentication tokens are stored securely using VS Code's Secret Storage API
• No credentials are stored in plain text
• The extension only communicates with guidemyai.tech APIs
• All data transmission uses HTTPS

Contributing

Contributions are welcome! This project is open source under the GPL-3.0 license.

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

Support

• 🐛 Issues and feature Requests: GitHub Issues
• 💬 Discussions: GitHub Discussions
• 📧 Email: For private inquiries

License

This extension is licensed under the GPL-3.0 License. See LICENSE.md for details.

Links

• Website
• GitHub Repository Open VSX Registry
• VS Code Marketplace

Enjoy coding with AI profiles tailored to your needs! 🚀