docs: update CONTRIBUTING.md with proper setup commands and Infisical guide link (#279)

Author: thisisharsh7

.env.example

@@ -0,0 +1,45 @@
+# AI API Keys
+ANTHROPIC_API_KEY=dummy_anthropic_key
+ANTHROPIC_API_KEY2=dummy_anthropic_key_2
+OPEN_AI_KEY=dummy_openai_key
+GEMINI_API_KEY=dummy_gemini_key
+DEEPSEEK_API_KEY=dummy_deepseek_key
+OPEN_ROUTER_API_KEY=dummy_openrouter_key
+HELICONE_API_KEY=dummy_helicone_key
+
+# Database & Server
+DATABASE_URL=postgresql://postgres:secretpassword_local@localhost:5432/codebuff
+PORT=4242
+GOOGLE_CLOUD_PROJECT_ID=dummy_project_id
+
+# Authentication
+CODEBUFF_GITHUB_ID=dummy_github_id
+CODEBUFF_GITHUB_SECRET=dummy_github_secret
+NEXTAUTH_SECRET=dummy_nextauth_secret_at_least_32_chars_long
+API_KEY_ENCRYPTION_SECRET=dummy_encryption_secret_32_chars
+
+# Payment (Stripe)
+STRIPE_SECRET_KEY=sk_test_dummy_stripe_secret
+STRIPE_WEBHOOK_SECRET_KEY=whsec_dummy_webhook_secret
+STRIPE_USAGE_PRICE_ID=price_dummy_usage_id
+STRIPE_TEAM_FEE_PRICE_ID=price_dummy_team_fee_id
+
+# External Services
+RELACE_API_KEY=dummy_relace_key
+LINKUP_API_KEY=dummy_linkup_key
+LOOPS_API_KEY=dummy_loops_key
+
+# Discord Integration
+DISCORD_PUBLIC_KEY=dummy_discord_public_key
+DISCORD_BOT_TOKEN=dummy_discord_bot_token
+DISCORD_APPLICATION_ID=dummy_discord_app_id
+
+# Frontend/Public Variables
+NEXT_PUBLIC_CB_ENVIRONMENT=development
+NEXT_PUBLIC_CODEBUFF_APP_URL=http://localhost:3000
+NEXT_PUBLIC_CODEBUFF_BACKEND_URL=http://localhost:3001
+NEXT_PUBLIC_SUPPORT_EMAIL=support@codebuff.com
+NEXT_PUBLIC_POSTHOG_API_KEY=phc_dummy_posthog_key
+NEXT_PUBLIC_POSTHOG_HOST_URL=https://app.posthog.com
+NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_test_dummy_publishable
+NEXT_PUBLIC_STRIPE_CUSTOMER_PORTAL=https://billing.stripe.com/p/login/test_dummy

CONTRIBUTING.md

@@ -39,13 +39,19 @@ Before you begin, you'll need to install a few tools:
 4. **Set up secrets management**:
 
    ```bash
+   npm install -g @infisical/cli
    infisical init
    infisical login
    # Select "US" region when prompted
-   infisical secrets  # Verify setup works
    ```
 
-   You will need to populate all the secrets in the infisical UI at https://app.infisical.com. You can provide dummy values for the secrets if you get an error about missing secrets, but you will need to update them with real values in order to use the associated feature.
+   Follow the [Infisical Setup Guide](./INFISICAL_SETUP_GUIDE.md) for detailed setup instructions.
+
+   Load all environment variables at once:
+   ```bash
+   infisical secrets set --file .env.example
+   infisical secrets set DATABASE_URL=postgresql://postgres:secretpassword_local@localhost:5432/codebuff
+   ```
 
 5. **Configure environment**:
 
@@ -62,16 +68,21 @@ Before you begin, you'll need to install a few tools:
 7. **Start development services** (requires 3 terminals):
 
    ```bash
-   # Terminal 1 - Backend server
+   # Terminal 1 - Backend server (start first)
    bun run start-server
+   # Expected: 🚀 Server is running on port 4242
 
-   # Terminal 2 - Web server
+   # Terminal 2 - Web server (start second)
    bun run start-web
+   # Expected: Ready on http://localhost:3000
 
-   # Terminal 3 - CLI client
+   # Terminal 3 - CLI client (start last)
    bun run start-bin
+   # Expected: Welcome to Codebuff! + agent list
    ```
 
+   **Note**: CLI requires both backend and web server running for authentication.
+
 ## Understanding the Codebase
 
 Codebuff is organized as a monorepo with these main packages:
@@ -173,7 +184,7 @@ Level up the web interface in `web/` with better agent management, project templ
 
 - **direnv problems?** Make sure it's hooked into your shell, run `direnv allow`, and restart your terminal
 - **Script errors?** Double-check you're using bun for all commands
-- **Can't find files?** See our [local development guide](./local-development.md) for more detailed setup
+- **Infisical issues?** See our [Infisical Setup Guide](./INFISICAL_SETUP_GUIDE.md) for step-by-step instructions
 
 **Questions?** Jump into our [Discord community](https://codebuff.com/discord) - we're friendly and always happy to help!
 

INFISICAL_SETUP_GUIDE.md

@@ -0,0 +1,53 @@
+# Simple Infisical Setup for Codebuff
+
+Quick 5-step setup to get Codebuff running with Infisical secrets.
+
+## Setup Steps
+
+### 1. Install & Setup
+```bash
+npm install -g @infisical/cli
+infisical init
+infisical login
+# Select "US" region when prompted
+infisical secrets  # Verify setup works
+```
+
+### 2. Browser Login
+- Browser opens automatically to https://app.infisical.com
+- Login with **any email** (Gmail, etc.)
+- Fill in any **name** and **organization name** when asked
+- Copy the token from browser and paste in terminal
+
+### 3. Select Project  
+- Use arrow keys to choose your organization
+- Select or create a Codebuff project
+
+### 4. Load Environment Variables
+```bash
+# Load all variables at once
+infisical secrets set --file .env.example
+
+# IMPORTANT: Fix the database password separately
+infisical secrets set DATABASE_URL=postgresql://postgres:secretpassword_local@localhost:5432/codebuff
+```
+
+### 5. Done! Run Codebuff
+```bash
+bun run start-server  # Backend (port 4242)
+bun run start-web     # Web (port 3000)  
+bun run start-bin     # CLI
+```
+
+## Common Issues & Quick Fixes
+
+**Token won't paste?** → Right-click → paste  
+**Database error?** → Run the DATABASE_URL command above  
+**Can't navigate menus?** → Use arrow keys ↓ ↑  
+
+## That's It!
+
+The `.env.example` file contains all the dummy values needed for development. Only the database password needs to be fixed to match Docker's password.
+
+You will need to populate all the secrets in the Infisical UI at https://app.infisical.com. You can provide dummy values for the secrets if you get an error about missing secrets, but you will need to update them with real values in order to use the associated feature.
+