Merge branch 'main' of https://github.com/parikhvedant2003/codebuff into markdown_fix

Author: parikhvedant2003

CONTRIBUTING.md

@@ -50,29 +50,18 @@ Before you begin, you'll need to install a few tools:
 
 5. **Start development services**:
 
-   **Option A: All-in-one (recommended)**
-
-   ```bash
-   bun run dev
-   # Starts the web server, builds the SDK, and launches the CLI automatically
-   ```
-
-   **Option B: Separate terminals (for more control)**
-
    ```bash
-   # Terminal 1 - Web server (start first)
+   # Terminal 1 - Start the web server first
    bun run start-web
    # Expected: Ready on http://localhost:3000
 
-   # Terminal 2 - CLI client (requires web server to be running first)
+   # Terminal 2 - Start the CLI (requires web server to be running)
    bun run start-cli
    # Expected: Welcome to Codebuff! + agent list
    ```
 
    Now, you should be able to run the CLI and send commands, but it will error out because you don't have any credits.
 
-   **Note**: CLI requires the web server running for authentication.
-
 6. **Giving yourself credits**:
 
    1. Log into Codebuff at [http://localhost:3000/login](http://localhost:3000/login)

cli/release/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codebuff",
-  "version": "1.0.620",
+  "version": "1.0.621",
   "description": "AI coding agent",
   "license": "MIT",
   "bin": {

cli/src/index.tsx

@@ -197,6 +197,26 @@ async function main(): Promise<void> {
   const startCwd = process.cwd()
   const showProjectPicker = shouldShowProjectPicker(startCwd, homeDir)
 
+  // Initialize analytics early, before anything that might use the logger
+  // (the logger calls trackEvent, which throws if analytics isn't initialized)
+  try {
+    initAnalytics()
+
+    // Track app launch event
+    trackEvent(AnalyticsEvent.APP_LAUNCHED, {
+      version: loadPackageVersion(),
+      platform: process.platform,
+      arch: process.arch,
+      hasInitialPrompt: Boolean(initialPrompt),
+      hasAgentOverride: hasAgentOverride,
+      continueChat,
+      initialMode: initialMode ?? 'DEFAULT',
+    })
+  } catch (error) {
+    // Analytics initialization is optional - don't fail the app if it errors
+    logger.debug(error, 'Failed to initialize analytics')
+  }
+
   // Initialize agent registry (loads user agents via SDK).
   // When --agent is provided, skip local .agents to avoid overrides.
   if (isPublishCommand || !hasAgentOverride) {
@@ -231,25 +251,6 @@ async function main(): Promise<void> {
     }
   }
 
-  // Initialize analytics
-  try {
-    initAnalytics()
-
-    // Track app launch event
-    trackEvent(AnalyticsEvent.APP_LAUNCHED, {
-      version: loadPackageVersion(),
-      platform: process.platform,
-      arch: process.arch,
-      hasInitialPrompt: Boolean(initialPrompt),
-      hasAgentOverride: hasAgentOverride,
-      continueChat,
-      initialMode: initialMode ?? 'DEFAULT',
-    })
-  } catch (error) {
-    // Analytics initialization is optional - don't fail the app if it errors
-    logger.debug(error, 'Failed to initialize analytics')
-  }
-
   if (clearLogs) {
     clearLogFile()
   }

knowledge.md

@@ -33,19 +33,23 @@ Codebuff is a tool for editing codebases via natural-language instructions to Bu
 
 ## Development
 
-Start everything:
+Start the web server first:
 
 ```bash
-bun dev
+bun up
 ```
 
-Or run services + CLI separately:
+Then start the CLI separately:
 
 ```bash
-bun up
 bun start-cli
-bun ps
-bun down
+```
+
+Other service commands:
+
+```bash
+bun ps    # check running services
+bun down  # stop services
 ```
 
 Worktrees (run multiple stacks on different ports): create `.env.development.local`:

sdk/e2e/utils/e2e-mocks.ts

@@ -344,7 +344,7 @@ async function* promptAiSdkStreamMock(
     await params.onCostCalculated(0)
   }
 
-  return `mock-message-${Math.random().toString(36).slice(2, 10)}`
+  return promptSuccess(`mock-message-${Math.random().toString(36).slice(2, 10)}`)
 }
 
 async function promptAiSdkMock(
@@ -393,7 +393,7 @@ export function setupE2eMocks(): void {
     async ({ fields }) =>
       Object.fromEntries(
         fields.map((field) => [field, MOCK_USER[field]]),
-      ) as Awaited<ReturnType<typeof databaseModule.getUserInfoFromApiKey>>,
+      ) as unknown as Awaited<ReturnType<typeof databaseModule.getUserInfoFromApiKey>>,
   )
   spyOn(databaseModule, 'fetchAgentFromDatabase').mockImplementation(
     async ({ parsedAgentId }) => buildMockAgentTemplate(parsedAgentId),

web/src/content/advanced/troubleshooting.mdx

@@ -9,6 +9,14 @@ order: 1
 
 [Open an issue](https://github.com/CodebuffAI/codebuff/issues) or check existing reports.
 
+## Install Node
+
+If you don't have `npm`, [get Node here](https://nodejs.org/en/download).
+
+## Delete local cache
+
+Codebuff stores files at `~/.config/manicode` including the binary `codebuff`. Sometimes deleting the binary and restarting codebuff will fix issues.
+
 ## Version
 
 The latest version of the Codebuff client can be found on the [npm page](https://www.npmjs.com/package/codebuff).
@@ -17,10 +25,6 @@ Run `codebuff --version` to make sure you're on the latest version.
 
 Codebuff should auto-update. If not, try the steps below.
 
-## Codebuff not updating
-
-If you see the npm install run but Codebuff still isn't at the latest version, this is most likely an issue with npm's cache. Try running `npm cache clean --force` and then `npm install -g codebuff`.
-
 ## Install failed
 
 If `npm install -g codebuff` gave you an error regarding permissions, try using setting the owner of that directory to your user.
@@ -39,27 +43,6 @@ Include recent chats if you ask for help.
 
 ## Common Issues
 
-### Connection Issues
-
-If you see a message like this:
-
-```bash
-/Users/<youruser>/Library/pnpm/global/5/.pnpm/codebuff@someversion/node_modules/codebuff/dist/common/websockets/websocket-client.js:158
-                    reject(new Error(`Websocket message with txid ${txid} timed out.`));                           ^
-
-Error: Websocket message with txid 32 timed out.
-    at Timeout._onTimeout (/Users/<youruser>/Library/pnpm/global/5/.pnpm/codebuff@someversion/node_modules/codebuff/dist/common/websockets/websocket-client.js:158:28)
-    at listOnTimeout (node:internal/timers:594:17)
-    at process.processTimers (node:internal/timers:529:7)
-
-Node.js v22.12.0
-```
-
-it means you're having connection issues. In that case, try:
-
-1. Check your internet connection.
-2. Try logging out and back in with `logout` followed by `login`.
-
 ### Endless Auto-Updates
 
 If Codebuff keeps trying to update itself in a loop, check the items below:

web/src/content/advanced/what-models.mdx

@@ -14,20 +14,27 @@ Codebuff uses different models for different tasks. The orchestrator coordinates
 The main agent ("Buffy") coordinates everything:
 
 <MarkdownTable>
-  | Mode | Model | |------|-------| | Default | Claude Opus 4.6 | | Max | Claude
-  Opus 4.6 | | Free | MiniMax M2.5 |
+  | Mode | Model |
+  |------|-------|
+  | Default | Opus 4.6 |
+  | Plan | Opus 4.6 |
+  | Max | Opus 4.6 |
+  | Free | MiniMax M2.5 |
 </MarkdownTable>
 
 ## Subagents
 
 The orchestrator spawns these for specific jobs:
 
 <MarkdownTable>
-  | Task | Models | |------|--------| | Code editing | Claude Opus 4.6, GLM 4.7
-  | | Thinking/reasoning | Claude Opus 4.6, GPT-5.2 | | Code review | Claude
-  Opus 4.6, GPT-5.2 | | File discovery | Gemini 2.5 Flash Lite, Grok 4.1 Fast |
-  | Terminal commands | Claude Haiku 4.5, Grok 4.1 Fast | | Web/docs research |
-  Grok 4.1 Fast |
+  | Task | Models |
+  |------|--------|
+  | Code editing | Claude Opus 4.6, GLM 4.7 |
+  | Thinking/reasoning | Claude Opus 4.6, GPT-5.2 |
+  | Code review | Claude Opus 4.6, GPT-5.2 |
+  | File discovery | Gemini 2.5 Flash Lite, Grok 4.1 Fast |
+  | Terminal commands | Claude Haiku 4.5, Grok 4.1 Fast |
+  | Web/docs research | Grok 4.1 Fast |
 </MarkdownTable>
 
 Max mode runs multiple implementations in parallel and picks the best one. Default mode runs a single implementation pass. Free mode uses MiniMax M2.5 and includes code review support.

web/src/content/help/quick-start.mdx

@@ -27,34 +27,19 @@ cd /path/to/your-repo
 codebuff
 ```
 
-Codebuff has multiple [modes](/docs/tips/modes): `plan` for planning without file changes, `max` for better results at higher cost and time. You can invoke them in the slash menu with `/mode`.
+Check out the [modes](/docs/tips/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:
-
-```
-/init
-```
-
-### What `/init` Creates
-
-- `knowledge.md` — A starter file for documenting your project's setup commands, architecture, and coding conventions. Codebuff reads this to understand your project better.
-- `.agents/types/` — TypeScript type definitions for creating custom agents.
-
-### When to Use `/init`
+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](/docs/walkthroughs/creating-your-first-agent)!
 
 ## Troubleshooting
 
-If you run into issues during installation:
-
-1. **Permission issues** — The best fix is to install Node.js using [nvm](https://github.com/nvm-sh/nvm) or [fnm](https://github.com/Schniz/fnm), which avoids permission problems entirely. Then run `npm install -g codebuff` again.
+- Make sure you have [node installed](https://nodejs.org/en/download) (which includes npm).
 
-2. **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
+- Try deleting the downloaded binary at `~/.config/manicode/codebuff` and restarting codebuff.
 
-[Troubleshooting](/docs/advanced/troubleshooting) | [Discord](https://codebuff.com/discord)
+See [here](/docs/advanced/troubleshooting) for more help or ask in our [Discord](https://codebuff.com/discord).

web/src/content/tips/modes.mdx

@@ -10,10 +10,12 @@ order: 2
 Codebuff has four modes. Switch during a session with `Shift+Tab` or `/mode:` commands.
 
 <MarkdownTable>
-  | Mode | Model | Editor Agent | Code Review | | --- | --- | --- | --- | --- |
-  | Default | Claude Opus 4.6 | editor | Yes | | Max | Claude Opus 4.6 |
-  editor-multi-prompt | Yes | | Plan | Claude Opus 4.6 | None | No | | Free |
-  MiniMax M2.5 | editor-lite | No |
+  | Mode | Model | Editor Agent | Code Review |
+  | --- | --- | --- | --- | --- |
+  | Default | Claude Opus 4.6 | editor | Yes |
+  | Max | Claude Opus 4.6 | editor-multi-prompt | Yes |
+  | Plan | Claude Opus 4.6 | None | No |
+  | Free | MiniMax M2.5 | editor-lite | No |
 </MarkdownTable>
 
 ## Default