getting-started.mdx

title	Getting Started
section	help
tags	introduction setup
order	1

Getting Started

Welcome! Let's get you set up with Codebuff, the AI coding agent.

Installation

Install Codebuff globally using npm:

  npm install -g codebuff

Basic Usage

Start using Codebuff in your project directory:

  codebuff

Or, start a new project with one of our starter templates:

  codebuff --create nextjs project-name

That's it! Codebuff is now ready to help you with your coding tasks.

Troubleshooting Install

If you run into issues during installation:

1. Check Node Version

   • Make sure you have Node version 18+ installed
   • Verify your version: node --version

2. Permission Issues

   • On Mac/Linux: Try sudo npm install -g codebuff
   • On Windows: Run command prompt as administrator

3. Still Having Problems?

   • Try reinstalling Node using nvm or fnm
   • Run the Codebuff install command again

If you're still experiencing issues, check out our Troubleshooting guide or join our Discord community!