docs: update API key references to use ODEK_API_KEY as preferred

- Error message now includes ODEK_API_KEY in the chain (odek.go:300)
- Default config template uses sk-3f118462a62c46a4ab7948323ea5cd50 (main.go:492)
- README, API.md, PROVIDERS.md, CACHING.md, CONFIG.md, CHEATSHEET.md:
  all examples and code snippets updated to os.Getenv("ODEK_API_KEY")
- index.html landing page uses ODEK_API_KEY with fallbacks noted
- Makefile integration-test target accepts ODEK_API_KEY or DEEPSEEK_API_KEY

Canonical chain: ODEK_API_KEY → DEEPSEEK_API_KEY → OPENAI_API_KEY

Author: jkyberneees

Makefile

@@ -63,10 +63,10 @@ coverage-total: ## Print total coverage percentage
 # ── Test (with LLM) ────────────────────────────────────────────────────
 
 .PHONY: test-integration
-test-integration: ## Run integration tests (requires DEEPSEEK_API_KEY)
-	@test -n "$$DEEPSEEK_API_KEY" || { \
-		echo "ERROR: DEEPSEEK_API_KEY not set"; \
-		echo "  export DEEPSEEK_API_KEY=sk-..."; \
+test-integration: ## Run integration tests (requires ODEK_API_KEY or DEEPSEEK_API_KEY)
+	@test -n "$$ODEK_API_KEY$$DEEPSEEK_API_KEY" || { \
+		echo "ERROR: ODEK_API_KEY or DEEPSEEK_API_KEY not set"; \
+		echo "  export ODEK_API_KEY=sk-..."; \
 		exit 1; \
 	}
 	$(GO) test -tags=integration -count=1 -timeout 300s -run Integration ./...

README.md

@@ -8,8 +8,8 @@ One binary. One loop. Zero frameworks. ReAct (Reasoning + Acting) — think, the
 # Install
 go install github.com/BackendStack21/kode/cmd/odek@latest
 
-# Use (set DEEPSEEK_API_KEY or OPENAI_API_KEY)
-export DEEPSEEK_API_KEY=sk-...
+# Use (set ODEK_API_KEY, DEEPSEEK_API_KEY, or OPENAI_API_KEY)
+export ODEK_API_KEY=sk-...
 odek run "How many lines in go.mod?"
 # → 3 lines
 ```
@@ -176,7 +176,7 @@ import "github.com/BackendStack21/kode"
 
 agent, err := odek.New(odek.Config{
     Model:          "deepseek-chat",
-    APIKey:         os.Getenv("DEEPSEEK_API_KEY"),
+    APIKey:         os.Getenv("ODEK_API_KEY"),
     MaxIterations:  30,
     Tools:          []odek.Tool{&myCustomTool{}},
     SystemMessage:  "You are an expert at refactoring Go code.",

cmd/odek/main.go

@@ -489,7 +489,7 @@ Environment variables:
 const defaultConfigTemplate = `{
   "model": "deepseek-v4-flash",
   "base_url": "https://api.deepseek.com/v1",
-  "api_key": "${DEEPSEEK_API_KEY}",
+  "api_key": "${ODEK_API_KEY}",
   "thinking": "",
   "max_iterations": 90,
   "sandbox": false,

docs/API.md

@@ -26,7 +26,7 @@ import (
 func main() {
     agent, err := odek.New(odek.Config{
         Model:  "deepseek-v4-flash",
-        APIKey: os.Getenv("DEEPSEEK_API_KEY"),
+        APIKey: os.Getenv("ODEK_API_KEY"),
     })
     if err != nil {
         fmt.Fprintf(os.Stderr, "odek: %v\n", err)
@@ -46,7 +46,7 @@ func main() {
 Save, run:
 
 ```bash
-export DEEPSEEK_API_KEY=sk-...
+export ODEK_API_KEY=sk-...
 go mod init my-agent
 go mod tidy
 go run main.go
@@ -104,6 +104,7 @@ type Config struct {
 
     // API key for the LLM provider.
     // Falls back to DEEPSEEK_API_KEY, then OPENAI_API_KEY.
+    // Prefer ODEK_API_KEY for odek-specific configuration.
     APIKey string
 
     // Thinking depth — provider-specific semantics:
@@ -240,7 +241,7 @@ The agent loop:
 ```go
 agent, err := odek.New(odek.Config{
     Model:  "deepseek-chat",
-    APIKey: os.Getenv("DEEPSEEK_API_KEY"),
+    APIKey: os.Getenv("ODEK_API_KEY"),
     Tools:  []odek.Tool{&slackNotifier{}},
 })
 
@@ -252,7 +253,7 @@ result, err := agent.Run(ctx, "Send a Slack message saying 'Deploy complete'")
 ```go
 agent, err := odek.New(odek.Config{
     Model:         "deepseek-v4-flash",
-    APIKey:        os.Getenv("DEEPSEEK_API_KEY"),
+    APIKey:        os.Getenv("ODEK_API_KEY"),
     SystemMessage: "You are a Go code reviewer. Be concise and specific.",
     MaxIterations: 15,
 })
@@ -373,7 +374,7 @@ func (t *gitLogTool) Call(args string) (string, error) {
 ```go
 agent, _ := odek.New(odek.Config{
     Model: "deepseek-chat",
-    APIKey: os.Getenv("DEEPSEEK_API_KEY"),
+    APIKey: os.Getenv("ODEK_API_KEY"),
     Tools:  []odek.Tool{&gitLogTool{}},
 })
 
@@ -452,7 +453,7 @@ Memory is enabled by default when odek loads a config file with memory settings.
 ```go
 agent, _ := odek.New(odek.Config{
     Model:  "deepseek-chat",
-    APIKey: os.Getenv("DEEPSEEK_API_KEY"),
+    APIKey: os.Getenv("ODEK_API_KEY"),
     // Memory is enabled via config file (~/.odek/config.json or ./odek.json)
     // In CLI mode, the --memory flag enables it automatically
 })
@@ -571,7 +572,7 @@ agent, err := odek.New(odek.Config{
     Model:  "deepseek-chat",
     APIKey: "", // missing!
 })
-// err: "odek: no API key provided (set DEEPSEEK_API_KEY or OPENAI_API_KEY)"
+// err: "odek: no API key provided (set ODEK_API_KEY, DEEPSEEK_API_KEY, or OPENAI_API_KEY)"
 ```
 
 ### Run failures
@@ -722,7 +723,7 @@ func (t *slackNotifyTool) Call(args string) (string, error) {
 func main() {
     agent, err := odek.New(odek.Config{
         Model:         "deepseek-v4-flash",
-        APIKey:        os.Getenv("DEEPSEEK_API_KEY"),
+        APIKey:        os.Getenv("ODEK_API_KEY"),
         SystemMessage: "You are a build engineer analyzing Go projects. Use line_count to examine files and slack_notify to report results.",
         MaxIterations: 10,
         Tools: []odek.Tool{

docs/CACHING.md

@@ -41,7 +41,7 @@ export ODEK_PROMPT_CACHING=true
 ```go
 agent, err := odek.New(odek.Config{
     Model:         "claude-sonnet-4",
-    APIKey:        os.Getenv("ANTHROPIC_API_KEY"),
+    APIKey:        os.Getenv("ODEK_API_KEY"),
     BaseURL:       "https://api.anthropic.com/v1",
     PromptCaching: true,
 })

docs/CHEATSHEET.md

@@ -199,6 +199,7 @@ odek mcp --sse-addr :8081                   # SSE transport
 | `ODEK_NO_AGENTS` | no_agents |
 | `ODEK_MAX_CONCURRENCY` | max_concurrency |
 | `ODEK_CTX` | ctx (comma-separated file paths) |
+| `ODEK_API_KEY` | api_key (preferred) |
 | `DEEPSEEK_API_KEY` | api_key (fallback) |
 | `OPENAI_API_KEY` | api_key (final fallback) |
 

docs/CONFIG.md

@@ -23,7 +23,7 @@ Shared across all projects:
 {
   "model": "deepseek-v4-flash",
   "base_url": "https://api.deepseek.com/v1",
-  "api_key": "${DEEPSEEK_API_KEY}",
+  "api_key": "${ODEK_API_KEY}",
   "thinking": "",
   "max_iterations": 90,
   "sandbox": false,

docs/PROVIDERS.md

@@ -5,14 +5,16 @@ odek is provider-agnostic. Any endpoint that speaks the OpenAI `/chat/completion
 ## Deepseek
 
 ```bash
-export DEEPSEEK_API_KEY=sk-...
-odek run --model deepseek-chat "task"
+export ODEK_API_KEY=sk-...
+# Or use DEEPSEEK_API_KEY (fallback)
+odek run --model deepseek-v4-flash "task"
 ```
 
 ## OpenAI
 
 ```bash
-export OPENAI_API_KEY=sk-...
+export ODEK_API_KEY=sk-...
+# Or use OPENAI_API_KEY (final fallback)
 odek run --model gpt-4o --base-url https://api.openai.com/v1 "task"
 ```
 
@@ -21,7 +23,7 @@ odek run --model gpt-4o --base-url https://api.openai.com/v1 "task"
 Any endpoint that accepts `POST /chat/completions` with an OpenAI-compatible JSON body works — Ollama, vLLM, LiteLLM, etc. No provider-specific code in odek.
 
 ```bash
-export OPENAI_API_KEY=not-needed
+export ODEK_API_KEY=not-needed
 odek run --model llama3 --base-url http://localhost:11434/v1 "task"
 ```
 

docs/index.html

@@ -559,7 +559,7 @@ <h2>Install in <span class="hl">5 seconds</span></h2>
     </li>
     <li>
       <span class="n">3</span>
-      <span>Set your API key: <code>export DEEPSEEK_API_KEY=sk-...</code> or <code>OPENAI_API_KEY</code></span>
+      <span>Set your API key: <code>export ODEK_API_KEY=sk-...</code> (or <code>DEEPSEEK_API_KEY</code> / <code>OPENAI_API_KEY</code>)</span>
     </li>
     <li>
       <span class="n">4</span>

odek.go

@@ -297,7 +297,7 @@ func New(cfg Config) (*Agent, error) {
 		}
 	}
 	if cfg.APIKey == "" {
-		return nil, fmt.Errorf("odek: no API key provided (set DEEPSEEK_API_KEY or OPENAI_API_KEY)")
+		return nil, fmt.Errorf("odek: no API key provided (set ODEK_API_KEY, DEEPSEEK_API_KEY, or OPENAI_API_KEY)")
 	}
 	if cfg.Model == "" {
 		cfg.Model = defaultModel