HAX — HashFy Assistant Xpert (BETA)

AI-powered development assistant with voice interaction and intelligent code execution directly in VS Code.

🚀 Features

🎤 Voice-Powered AI Assistant

• Natural Voice Interaction: Talk to HAX using your microphone with real-time audio streaming
• Gemini Live API: Powered by Google's Gemini 2.5 Flash with native audio preview
• Visual Feedback: Real-time voice visualization during conversations
• AI Voice: Powered by Aoede voice for natural interaction

🧠 Intelligent Command Execution

• Context-Aware: Understands your project structure and executes commands intelligently
• Error Diagnosis: Automatic error detection with suggested fixes
• Dry-Run Mode: Test commands safely before execution
• Command History: Full audit log with timestamps and results

🔧 Developer Tools

• Firebase Management:
  • Firestore operations (query, create, update, delete)
  • Authentication user management
  • Storage file operations
  • Hosting deployments
• Terminal Operations: Execute shell commands with smart output handling
• File Operations: Read, write, search, and manage files
• Git Integration: Commit, push, pull, branch management

🌍 Multilingual Support

• Full Bilingual Interface: English and Portuguese
• Any Language Voice Input: Speak in any language, HAX will understand
• Easy Switching: Change interface language anytime from the header

🎨 Display Modes

• Simple Mode: Clean, minimal widget cards for command results
• Advanced Mode: Detailed terminal-style output with syntax highlighting

🔐 Security

• Credential Vault: Secure storage for API keys and credentials
• No External Storage: All credentials stored locally in VS Code secrets
• Firebase Admin: Secure backend authentication

� Pricing

HAX requires an active subscription to use:

• Individual: $9.99/month - Perfect for solo developers and small projects

Your subscription helps HashFy continue developing and improving HAX with new features and capabilities.

�📦 Installation

1. From VS Code Marketplace:

   • Open VS Code
   • Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
   • Search for "HAX" or "HashFy Assistant Xpert"
   • Click Install

2. From VSIX:

   code --install-extension hax-vscode-0.1.0.vsix
   

⚙️ Setup

1. Sign Up with Google:

   • Open HAX in VS Code
   • Click "Sign In" and authenticate with your Google account

2. Subscribe to Individual Plan:

   • Complete the subscription process ($9.99/month)
   • Your subscription is now active

3. Get a Gemini API Key:

   • Visit Google AI Studio
   • Create a new API key
   • Copy the key

4. Add Your Gemini API Key:

   • Return to HAX in VS Code
   • Click the settings icon and paste your Gemini API key
   • Or use Command Palette: HAX: Configure Gemini API Key

5. Start Your First Conversation:

   • Click "Start Session"
   • Allow microphone access when your browser opens
   • Start talking to HAX!

🎯 Usage

Voice Commands

1. Click the microphone button or "Start Session"
2. Speak naturally: "List all files in src", "Create a new React component", "Deploy to Firebase"
3. HAX will execute commands and show results

Text Commands

• Type in the input box for text-only interaction
• Press Enter or click Send

Common Commands

• Files: "Show me the files in src", "Read the package.json file"
• Git: "Commit these changes", "Push to origin", "Create a new branch"
• Firebase: "List Firestore users", "Deploy to hosting", "Query the database"
• Terminal: "Run npm install", "Check Node version", "Build the project"

⚡ Keyboard Shortcuts

• Ctrl+Shift+H (Windows/Linux) or Cmd+Shift+H (Mac): Open HAX panel

🛠️ Configuration

HAX uses default settings optimized for the best experience. Configuration is handled through the extension interface.

📊 Requirements

• VS Code 1.85.0 or higher
• Node.js 18+ (for development)
• Gemini API Key (free tier available)
• Microphone (for voice interaction)

🔒 Privacy & Security

• All credentials stored locally in VS Code Secrets API
• Voice data sent only to Google Gemini API (encrypted)
• Subscription validation via secure HTTPS
• No code or sensitive data sent to HashFy servers
• Full GDPR compliance
• SOC 2 Type II certified

🐛 Known Issues

• Audio interruption currently cancels running commands (fix planned)
• Some Firebase operations require additional permissions

🗺️ Roadmap

• [ ] Audio interruption without command cancellation
• [ ] More language support (Spanish, French, German)
• [ ] AWS and Azure integrations
• [ ] Code generation and refactoring tools
• [ ] Team collaboration features
• [ ] Real-time pair programming with AI
• [ ] Custom model training on your codebase

📝 Changelog

See CHANGELOG.md for version history.

📄 License

© 2026 HashFy. All rights reserved.

💬 Support

• Email: haxvscode@hashfy.com.br
• Website & Community: https://www.hashfy.com.br

Made with ❤️ by HashFy