Get started with Codebuff
1. Install Codebuff
Enter the following in your terminal, which could be inside your favorite IDE (VSCode, Cursor, etc.).
npm install -g codebuff
2. Navigate to your project directory
cd /path/to/your-repo
3. Run Codebuff
codebuff
Check out the modes for using Codebuff, such as Free, Max, or Plan.
4. Initialize Your Project (Optional)
Run the /init command inside Codebuff to set up project-specific files. Useful for:
- New projects — if you don't already have an AGENTS.md or CLAUDE.md (Codebuff will also read these files).
- Building custom agents — running /init is the first step to creating your own agents!
Troubleshooting
-
Make sure you have node installed (which includes npm).
-
Try deleting the downloaded binary at
~/.config/manicode/codebuffand restarting codebuff.