121 lines
3.6 KiB
Markdown
121 lines
3.6 KiB
Markdown
# ✅ Avante Installation Checklist
|
|
|
|
## What Was Done
|
|
|
|
✅ **1. Created Avante Plugin Configuration**
|
|
- File: `/Users/stuartstephens/.config/nvim/lua/custom/plugins/avante.lua`
|
|
- Provider: `copilot` (uses your existing OpenAI API key)
|
|
- Model: `gpt-4o` (latest GPT-4 Omni model)
|
|
- Dependencies: telescope, fzf-lua, nui, dressing, snacks
|
|
- Auto-suggestions: Disabled to save API costs
|
|
|
|
✅ **2. Set Up Keybindings** (No Conflicts!)
|
|
```
|
|
<leader>aa → Ask Avante about code
|
|
<leader>ae → Edit with Avante
|
|
<leader>at → Toggle sidebar
|
|
<leader>ar → Refactor
|
|
<leader>ax → Execute slash command
|
|
<leader>ad → Document code
|
|
<leader>af → Fix issues
|
|
```
|
|
|
|
✅ **3. Configured for Your Existing Copilot Premium**
|
|
- Uses your existing `OPENAI_API_KEY` environment variable
|
|
- No second subscription needed
|
|
- Same API key as OpenCode uses (if you have it set)
|
|
|
|
✅ **4. Created Setup Documentation**
|
|
- File: `AVANTE_SETUP.md` in your nvim config
|
|
- Quick reference guide for all features
|
|
- Troubleshooting tips
|
|
|
|
## Current Status
|
|
|
|
🔄 **Lazy.nvim is installing Avante now**
|
|
- Cloning repository
|
|
- Installing dependencies (avante.nvim, fzf-lua, etc.)
|
|
- Building Rust components
|
|
- Should complete shortly
|
|
|
|
## Next Steps
|
|
|
|
### ⏳ When Installation Completes (in a few minutes):
|
|
|
|
1. **Restart Neovim** - Open any file: `nvim ~/.config/nvim/init.lua`
|
|
|
|
2. **Verify Installation**
|
|
```
|
|
:checkhealth avante
|
|
```
|
|
Should show green checkmarks for all components
|
|
|
|
3. **Test It Out**
|
|
- Open any code file
|
|
- Select a function: `v` + select lines
|
|
- Press `<leader>aa` to ask Avante a question
|
|
- Or press `<leader>at` to toggle the sidebar
|
|
|
|
4. **Compare Workflows**
|
|
- Try `<leader>oa` (OpenCode) vs `<leader>aa` (Avante)
|
|
- See which feels better for your workflow
|
|
- Document your preference
|
|
|
|
### 📊 Comparison Points to Test
|
|
|
|
| Aspect | OpenCode | Avante |
|
|
|--------|----------|--------|
|
|
| **Startup** | Terminal-based | Integrated in Neovim |
|
|
| **UI** | TUI in terminal | Sidebar panel |
|
|
| **Speed** | Full agent system | Quick suggestions |
|
|
| **Best for** | Complex tasks | Quick edits |
|
|
| **Keybinding** | `<leader>o*` | `<leader>a*` |
|
|
|
|
## ⚠️ Important Notes
|
|
|
|
1. **API Key**: Avante needs `OPENAI_API_KEY` environment variable set
|
|
- Verify: `echo $OPENAI_API_KEY`
|
|
- Set it: Add to `~/.zshrc`: `export OPENAI_API_KEY="sk-..."`
|
|
|
|
2. **Costs**: Both tools use the same OpenAI API, so usage is cumulative
|
|
- Monitor costs at https://platform.openai.com/account/billing/overview
|
|
|
|
3. **Model**: Avante uses `gpt-4o` by default
|
|
- Switch to cheaper model (e.g., `gpt-4o-mini`) if needed
|
|
- Edit: `/lua/custom/plugins/avante.lua` → change `model` value
|
|
|
|
4. **Keybindings**: Zero conflicts with existing setup
|
|
- `<leader>o*` → OpenCode (unchanged)
|
|
- `<leader>a*` → Avante (new)
|
|
- All other bindings unaffected
|
|
|
|
## 📚 Documentation Files
|
|
|
|
- **This file**: Current checklist and status
|
|
- **AVANTE_SETUP.md**: Full setup guide with troubleshooting
|
|
- **avante.lua**: Plugin configuration with inline comments
|
|
|
|
## 🎯 Success Criteria
|
|
|
|
You'll know Avante is working when:
|
|
|
|
✓ Neovim starts without errors
|
|
✓ `:checkhealth avante` shows green checks
|
|
✓ `<leader>at` toggles a sidebar panel
|
|
✓ `<leader>aa` on selected code shows Avante chat
|
|
✓ You can type questions and get responses
|
|
|
|
## 💬 Ready to Test?
|
|
|
|
Once the installation finishes, just:
|
|
1. Open Neovim
|
|
2. Press `<leader>at` to toggle the Avante sidebar
|
|
3. Select some code
|
|
4. Press `<leader>aa` to ask Avante a question!
|
|
|
|
---
|
|
|
|
**Installation started**: Feb 1, 2025
|
|
**Status**: Downloading dependencies...
|
|
**Next check**: In ~5 minutes after plugin finishes building
|