Update freebuff error when not available in your country. Update website/readme

Author: jahooma

cli/src/utils/__tests__/error-handling.test.ts

@@ -103,12 +103,8 @@ describe('error-handling', () => {
   })
 
   describe('FREE_MODE_UNAVAILABLE_MESSAGE', () => {
-    test('mentions free mode', () => {
-      expect(FREE_MODE_UNAVAILABLE_MESSAGE.toLowerCase()).toContain('free mode')
-    })
-
-    test('mentions paid plan', () => {
-      expect(FREE_MODE_UNAVAILABLE_MESSAGE.toLowerCase()).toContain('paid plan')
+    test('mentions unavailability in country', () => {
+      expect(FREE_MODE_UNAVAILABLE_MESSAGE.toLowerCase()).toContain('not available in your country')
     })
   })
 

cli/src/utils/error-handling.ts

@@ -2,6 +2,8 @@ import { env } from '@codebuff/common/env'
 
 import type { ChatMessage } from '../types/chat'
 
+import { IS_FREEBUFF } from './constants'
+
 const defaultAppUrl = env.NEXT_PUBLIC_CODEBUFF_APP_URL || 'https://codebuff.com'
 
 // Normalize unknown errors to a user-facing string.
@@ -57,8 +59,9 @@ export const isFreeModeUnavailableError = (error: unknown): boolean => {
 
 export const OUT_OF_CREDITS_MESSAGE = `Out of credits. Please add credits at ${defaultAppUrl}/usage`
 
-export const FREE_MODE_UNAVAILABLE_MESSAGE =
-  'Free mode is not available outside of the United States and Canada. Please upgrade to a paid plan to use Codebuff outside the US and Canada.'
+export const FREE_MODE_UNAVAILABLE_MESSAGE = IS_FREEBUFF
+  ? 'Freebuff is not available in your country.'
+  : 'Free mode is not available in your country. You can use another mode to continue.'
 
 export const createErrorMessage = (
   error: unknown,

docs/error-schema.md

@@ -35,7 +35,7 @@ Used for errors that the client needs to identify programmatically:
 | Status | `error` code | Example `message` |
 |--------|-------------|-------------------|
 | 403 | `account_suspended` | `"Your account has been suspended due to billing issues. Please contact support@codebuff.com to resolve this."` |
-| 403 | `free_mode_unavailable` | `"Free mode is not available in your country."` |
+| 403 | `free_mode_unavailable` | `"Free mode is not available in your country."` (Freebuff: `"Freebuff is not available in your country."`) |
 | 429 | `rate_limit_exceeded` | `"Subscription weekly limit reached. Your limit resets in 2 hours. Enable 'Continue with credits' in the CLI to use a-la-carte credits."` |
 
 ### Catch-all server error

freebuff/README.md

@@ -21,7 +21,7 @@ freebuff
 
 **Simple** — No modes. No config. Just works.
 
-**Fast** — 5–10× speed up. 3–5× tokens per second compared to Claude, plus context gathering in seconds.
+**Fast** — 5–10× speed up. Faster models plus context gathering in seconds rather than minutes.
 
 **Loaded** — Built-in web research, browser use, and more.
 
@@ -58,6 +58,8 @@ freebuff
 
 **Are you training on my data?** No. We only use model providers that do not train on our requests. Your code stays yours.
 
+**Which countries is Freebuff available in?** Freebuff is currently available in select countries. See [freebuff.com](https://freebuff.com) for the full list.
+
 **What data do you store?** We don't store your codebase. We only collect minimal logs for debugging purposes.
 
 ## How It Works

freebuff/web/src/app/home-client.tsx

@@ -34,7 +34,7 @@ const faqs = [
   {
     question: 'Which countries is Freebuff available in?',
     answer:
-      'Freebuff is currently available in the United States, Canada, United Kingdom, Australia, Norway, Sweden, Netherlands, Denmark, Germany, Finland, Belgium, Luxembourg, Switzerland, Ireland, and Iceland.',
+      'Freebuff is currently available in the United States, Canada, United Kingdom, Australia, New Zealand, Norway, Sweden, Netherlands, Denmark, Germany, Finland, Belgium, Luxembourg, Switzerland, Ireland, and Iceland.',
   },
   {
     question: 'Are you training on my data?',