From 144d9d93de50f2ff98a04f81b6487d61890a679c Mon Sep 17 00:00:00 2001
From: Mario Zechner <badlogicgames@gmail.com>
Date: Wed, 24 Dec 2025 02:14:02 +0100
Subject: [PATCH] Update README with settings.json API keys

---
 packages/coding-agent/README.md | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/packages/coding-agent/README.md b/packages/coding-agent/README.md
index 8c4331a3..13a5081b 100644
--- a/packages/coding-agent/README.md
+++ b/packages/coding-agent/README.md
@@ -106,7 +106,20 @@ For most users, [Git for Windows](https://git-scm.com/download/win) is sufficien
 
 ### API Keys & OAuth
 
-Set the environment variable for your provider:
+**Option 1: Settings file** (recommended)
+
+Add API keys to `~/.pi/agent/settings.json`:
+
+```json
+{
+  "apiKeys": {
+    "anthropic": "sk-ant-...",
+    "openai": "sk-..."
+  }
+}
+```
+
+**Option 2: Environment variables**
 
 | Provider | Environment Variable |
 |----------|---------------------|
@@ -120,6 +133,8 @@ Set the environment variable for your provider:
 | OpenRouter | `OPENROUTER_API_KEY` |
 | ZAI | `ZAI_API_KEY` |
 
+Settings file keys take priority over environment variables.
+
 **OAuth Providers:**
 
 Use `/login` to authenticate with subscription-based or free-tier providers: