DevAgent Zero - AI Assistant

A comprehensive VS Code extension that integrates multiple AI models with advanced capabilities including terminal execution, web search, and MCP (Model Context Protocol) tools.

🚀 Features

🤖 Multiple AI Models Support

• OpenAI GPT Models: GPT-4, GPT-4 Turbo, GPT-3.5 Turbo
• Anthropic Claude Models: Claude 3 Opus, Sonnet, Haiku
• Google Gemini Models: Gemini Pro, Gemini Pro Vision

💻 Advanced Capabilities

• File Operations: Create, modify, analyze, and delete files in your workspace
• Terminal Execution: Execute shell commands directly from the AI (optional, disabled by default for security)
• Web Search: Search the internet for documentation and information
• MCP Tools: Model Context Protocol tools for enhanced functionality
• Workspace Context: AI understands your project structure and active files
• Chat Interface: Beautiful sidebar chat interface for natural conversations

🛡️ Security Features

• Safe by Default: Terminal execution disabled by default
• Path Validation: Prevents unsafe file operations outside workspace
• User Confirmation: Asks for confirmation before dangerous operations
• API Key Security: Store API keys securely in VS Code settings

📦 Installation

1. Install the extension from the VS Code marketplace
2. Configure your API keys in VS Code settings
3. Open the AI Assistant sidebar (robot icon in activity bar)
4. Start chatting with your AI assistant!

⚙️ Configuration

Open VS Code settings and configure the following:

API Keys (Required)

• devagentZero.openaiApiKey: Your OpenAI API key for GPT models
• devagentZero.claudeApiKey: Your Anthropic API key for Claude models
• devagentZero.geminiApiKey: Your Google API key for Gemini models

Model Settings

• devagentZero.defaultModel: Default AI model to use (default: gpt-4)

Feature Toggles

• devagentZero.enableTerminalExecution: Allow AI to execute terminal commands (default: false)
• devagentZero.enableWebSearch: Enable web search capabilities (default: true)
• devagentZero.enableMCPTools: Enable MCP tools support (default: true)

Performance Settings

• devagentZero.maxFiles: Maximum files to analyze (default: 15)
• devagentZero.maxChars: Maximum characters to send to AI (default: 30000)

🎯 Usage

Opening the AI Assistant

• Click the robot icon in the activity bar
• Use Ctrl+Shift+D (or Cmd+Shift+D on Mac)
• Command Palette: "DevAgent Zero: Open AI Assistant"

Example Prompts

• "Analyze my code and suggest improvements"
• "Create a README file for this project"
• "Help me debug this function"
• "Search for React best practices"
• "Run npm install in the terminal" (if terminal execution enabled)
• "Explain what this code does"
• "Refactor this component to use hooks"
• "Create unit tests for this module"

Model Selection

Choose from 8 different AI models in the dropdown:

• GPT-4: Most accurate, slower
• GPT-4 Turbo: Balanced speed/quality, supports vision
• GPT-3.5 Turbo: Fastest, good for simple tasks
• Claude 3 Opus: Most capable Claude model
• Claude 3 Sonnet: Balanced Claude model
• Claude 3 Haiku: Fastest Claude model
• Gemini Pro: Google's advanced model
• Gemini Pro Vision: Supports image analysis

🔧 Commands

• DevAgent Zero: Open AI Assistant - Open the sidebar chat interface
• DevAgent Zero: Interact with Agent - Legacy command (redirects to sidebar)
• DevAgent Zero: Execute Terminal Command - Execute a terminal command
• DevAgent Zero: Web Search - Perform a web search

🔑 Keyboard Shortcuts

• Ctrl+Shift+A (or Cmd+Shift+A): Legacy interact command
• Ctrl+Shift+D (or Cmd+Shift+D): Open AI Assistant sidebar

🛠️ Advanced Features

Terminal Execution

When enabled, the AI can execute terminal commands. This feature is disabled by default for security reasons. Enable it in settings if you trust the AI to run commands on your system.

Web Search Integration

The AI can search the web for information, documentation, and best practices. Results open in your default browser.

MCP Tools Support

Model Context Protocol (MCP) tools provide enhanced functionality for development workflows, context management, and advanced AI capabilities.

Workspace Context Awareness

The AI automatically analyzes your workspace structure, active files, and project context to provide more relevant assistance.

🔒 Security & Privacy

• API keys are stored securely in VS Code settings
• No data is sent to third parties except the configured AI providers
• Terminal execution requires explicit user permission
• File operations are restricted to the workspace directory
• All dangerous operations require user confirmation

🐛 Troubleshooting

API Key Issues

• Ensure your API keys are correctly configured in settings
• Check that your API keys have sufficient credits/quota
• Verify the API key format (OpenAI keys start with sk-)

Model Not Working

• Check if you have the correct API key for the selected model
• Some models may not be available in all regions
• Try switching to a different model

Terminal Commands Not Working

• Ensure devagentZero.enableTerminalExecution is set to true
• Check VS Code's integrated terminal permissions
• Verify the command syntax for your operating system

📝 License

MIT License - see LICENSE file for details.

🤝 Contributing

Contributions are welcome! Please feel free to submit issues and pull requests.

📞 Support

If you encounter any issues or have questions:

1. Check the troubleshooting section above
2. Open an issue on GitHub
3. Check the VS Code output panel for error messages

Enjoy coding with your AI assistant! 🤖✨