AX CLI - VSCode Extension

AI-powered coding assistant with true multi-provider flexibility

🚀 Features

Multi-Provider AI Support

Switch between multiple AI providers without being locked in:

• Grok (xAI) - Fast coding assistance
• GLM 4.6 (ZhipuAI) - Advanced reasoning
• Claude 3.5 (Anthropic) - Code understanding
• GPT-4o (OpenAI) - General purpose
• DeepSeek - Cost-effective alternative
• Local Models (Ollama) - Privacy-first option

Sidebar Chat Interface

• Modern, responsive chat UI
• Markdown and code highlighting
• Copy and apply code blocks
• Conversation history
• Context-aware responses

Context Awareness

Automatically includes relevant context:

• Current file
• Code selection
• Line ranges
• Git changes
• Error diagnostics

Quick Commands

• Analyze File: Deep analysis of current file
• Explain Selection: Understand selected code
• Generate Tests: Create unit tests
• Refactor Code: Suggest improvements
• Find Bugs: Detect potential issues
• Review Changes: Git diff analysis

📦 Installation

Prerequisites

1. Install AX CLI:

   npm install -g @defai.digital/ax-cli
   

2. Configure API Key:

   # For Grok (default)
   export GROK_API_KEY=your_api_key
   
   # Or for other providers
   export ANTHROPIC_API_KEY=your_key
   export OPENAI_API_KEY=your_key
   

Install Extension

Option 1: From Marketplace (Coming Soon)

• Search "AX CLI" in VSCode Extensions
• Click Install

Option 2: From VSIX

code --install-extension ax-cli-vscode-0.1.0.vsix

Option 3: Development

cd vscode-extension
npm install
npm run compile
# Press F5 to launch Extension Development Host

🎯 Usage

Open Chat

• Click AX icon in Activity Bar (sidebar)
• Or: Cmd+Shift+A (Mac) / Ctrl+Shift+A (Windows/Linux)
• Or: Command Palette → "AX: Open Chat"

Ask Questions

1. Type your question in the input box
2. Press Enter or click Send
3. AI responds with formatted answer
4. Click "Apply" to insert code blocks

Use Commands

• Right-click in editor → "AX: ..." commands
• Or use keyboard shortcuts:
  • Cmd+Shift+E: Explain Selection
  • Access others via Command Palette

Change Model

• Click model name in status bar (bottom right)
• Select from dropdown
• Settings persist across sessions

⚙️ Configuration

Extension Settings

Open Settings (Cmd+,) and search "AX CLI":

Workspace Settings

Create .vscode/settings.json in your project:

{
  "ax-cli.model": "glm-4.6",
  "ax-cli.autoIncludeFile": true
}

🔥 Examples

Analyze Current File

1. Open a file
2. Run: "AX: Analyze Current File"
3. Get suggestions for improvements

Explain Code

1. Select code snippet
2. Press Cmd+Shift+E
3. Read detailed explanation

Generate Tests

1. Open file with functions
2. Run: "AX: Generate Tests"
3. Review generated test cases
4. Click "Apply" to create test file

Review Git Changes

1. Make code changes (don't commit)
2. Run: "AX: Review Git Changes"
3. Get feedback on your changes

🎨 Keyboard Shortcuts

Customize shortcuts in: Code → Preferences → Keyboard Shortcuts

🛠️ Development

Build Extension

npm run compile         # Build once
npm run watch           # Build + watch
npm run package         # Production build

Run Tests

npm test               # Run all tests
npm run test:watch     # Watch mode

Debug Extension

1. Open extension folder in VSCode
2. Press F5 to launch Extension Development Host
3. Set breakpoints in TypeScript files
4. Test extension in new window

Package VSIX

npm install -g vsce
vsce package
# Creates: ax-cli-vscode-0.1.0.vsix

📚 Documentation

• Main Documentation
• VSCode Integration Guide
• Phase 2 Summary
• API Reference

🤝 Contributing

Contributions welcome! See CONTRIBUTING.md

Reporting Issues

• GitHub Issues
• Include: VSCode version, extension version, error logs

Feature Requests

• GitHub Discussions
• Describe use case and expected behavior

🔒 Privacy & Security

• API Keys: Stored securely in VSCode settings
• Code Content: Only sent to configured AI provider
• Local Models: Use Ollama for complete privacy
• No Telemetry: Extension doesn't collect usage data

📄 License

MIT License - see LICENSE

🙏 Acknowledgments

• Built on top of AX CLI
• Uses VSCode Extension API
• Icons from VSCode Codicons

🗺️ Roadmap

Phase 2 (Current) ✅

• [x] Sidebar chat interface
• [x] Context-aware commands
• [x] Code application
• [x] Model switching

Phase 3 (Planned)

• [ ] Inline code suggestions
• [ ] Code actions provider
• [ ] Multi-file refactoring
• [ ] Diff viewer

Phase 4 (Future)

• [ ] Performance optimizations
• [ ] Advanced context analysis
• [ ] Custom prompts library
• [ ] Team collaboration features

💬 Support

• Documentation: docs.ax-cli.dev
• Issues: GitHub Issues
• Discussions: GitHub Discussions

Made with ❤️ by the AX CLI team