mirror
/
kickstart.nvim
mirror of https://github.com/nvim-lua/kickstart.nvim.git
1
0
Fork 1
Code Issues Packages Projects Releases Wiki Activity
kickstart.nvim/INSTALLATION_CHECKLIST.md

3.6 KiB
Raw Blame History

✅ 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

  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