From f69298d7ebb5ce7fac53978c6115e7373fd9c983 Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Sat, 17 Jan 2026 00:15:10 +0000
Subject: [PATCH] docs: clarify model key format

---
 src/commands/models/shared.ts | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/src/commands/models/shared.ts b/src/commands/models/shared.ts
index 956841474..2c0bc58cd 100644
--- a/src/commands/models/shared.ts
+++ b/src/commands/models/shared.ts
@@ -84,3 +84,13 @@ export function normalizeAlias(alias: string): string {
 
 export { modelKey };
 export { DEFAULT_MODEL, DEFAULT_PROVIDER };
+
+/**
+ * Model key format: "provider/model"
+ *
+ * The model key is displayed in `/model status` and used to reference models.
+ * When using `/model <key>`, use the exact format shown (e.g., "openrouter/moonshotai/kimi-k2").
+ *
+ * For providers with hierarchical model IDs (e.g., OpenRouter), the model ID may include
+ * sub-providers (e.g., "moonshotai/kimi-k2"), resulting in a key like "openrouter/moonshotai/kimi-k2".
+ */