fix: improve environment validation error messages (#461)

hiSandog · 陈家名 · 陈家名 · web-flow · commit 3a02b504f8b0 · 2026-03-09T13:05:07.000-07:00
Co-authored-by: 陈家名 &lt;chenjiaming@chenjiamingdeMacBook-Pro.local&gt;
Co-authored-by: 陈家名 &lt;chenjiaming@icloud.com&gt;
Co-authored-by: James Grugett &lt;jahooma@gmail.com&gt;
diff --git a/README.md b/README.md
@@ -157,6 +157,19 @@ Learn more about the SDK [here](https://www.npmjs.com/package/@codebuff/sdk).
 
 **SDK**: Build Codebuff into your applications. Create custom tools, integrate with CI/CD, or embed coding assistance into your products.
 
+## Advanced Usage
+
+### Custom Agent Workflows
+
+Create your own agents with specialized workflows using the `/init` command:
+
+```bash
+codebuff
+/init
+```
+
+This creates a custom agent structure in `.agents/` that you can customize.
+
 ## Contributing to Codebuff
 
 We ❤️ contributions from the community - whether you're fixing bugs, tweaking our agents, or improving documentation.
diff --git a/common/src/env.ts b/common/src/env.ts
@@ -2,7 +2,8 @@ import { clientEnvSchema, clientProcessEnv } from './env-schema'
 
 const parsedEnv = clientEnvSchema.safeParse(clientProcessEnv)
 if (!parsedEnv.success) {
-  throw parsedEnv.error
+  console.error('Environment validation failed:', parsedEnv.error.errors)
+  throw new Error(`Invalid environment configuration: ${parsedEnv.error.message}`)
 }
 
 export const env = parsedEnv.data

Original file line number	Diff line number	Diff line change
`@@ -2,7 +2,8 @@ import { clientEnvSchema, clientProcessEnv } from './env-schema'`
`2`	`2`
`3`	`3`	`const parsedEnv = clientEnvSchema.safeParse(clientProcessEnv)`
`4`	`4`	`if (!parsedEnv.success) {`
`5`		`- throw parsedEnv.error`
	`5`	`+ console.error('Environment validation failed:', parsedEnv.error.errors)`
	`6`	+ throw new Error(`Invalid environment configuration: ${parsedEnv.error.message}`)
`6`	`7`	`}`
`7`	`8`
`8`	`9`	`export const env = parsedEnv.data`