Get started with Codebuff
1. Install Codebuff
Enter the following in your terminal, which could be inside your favorite IDE (VSCode, Cursor, etc.).
bash
npm install -g codebuff
2. Navigate to your project directory
bash
cd /path/to/your-repo
3. Run Codebuff
bash
codebuff
Codebuff has multiple modes: lite for quick tasks, max for complex work, and plan for planning without file changes. You can invoke them in the slash menu with /mode:.
Troubleshooting
If you run into issues during installation:
-
Permission issues — The best fix is to install Node.js using nvm or fnm, which avoids permission problems entirely. Then run
npm install -g codebuffagain. -
Still Having Problems?
- On Mac/Linux, you can fix permissions with:
sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share} - On Windows, run your terminal as administrator
- On Mac/Linux, you can fix permissions with: