From 03fdaa5a76890de20d68fb210dfed4cf21fe1729 Mon Sep 17 00:00:00 2001
From: LaishGlenberg <lglenbe1@asu.edu>
Date: Tue, 23 Jun 2026 02:21:16 -0700
Subject: [PATCH] docs(readme): clarify custom agent model syntax

---
 README.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/README.md b/README.md
index c028e26..5b0a7bf 100644
--- a/README.md
+++ b/README.md
@@ -131,6 +131,20 @@ Example `settings.json` override for compatible API proxies:
 | One-click install | ✅ | ❌ | ✅ |
 | API key in OS keychain | ✅ | ❌ | ⚠️ varies |
 
+## Custom Agents (.agent.md)
+
+- Use this exact syntax for the `model` field, with the lowercase vendor name 'deepseek' in parenthesis
+
+```yaml
+model: 'DeepSeek V4 Flash (deepseek)'
+```
+
+- If using both Pro and Flash
+
+```yaml
+model: ['DeepSeek V4 Flash (deepseek)', 'DeepSeek V4 Pro (deepseek)']
+```
+
 ## License
 
 [MIT](LICENSE)