From 3aa17dcd8f6ca974dbd4b5350b88caa9731bbaa3 Mon Sep 17 00:00:00 2001
From: Aditya <82406617+adigo-pro@users.noreply.github.com>
Date: Sat, 1 Aug 2026 20:08:56 -0500
Subject: [PATCH] docs: install.sh next-steps + changelog for console-first
 model setup

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01A2CMGoziPn6h1vK94rSLeJ
---
 CHANGELOG.md | 20 ++++++++++++++++++++
 install.sh   |  7 ++++---
 2 files changed, 24 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 894a78d..1fb37d8 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,26 @@
 
 Notable changes. Format: [Keep a Changelog](https://keepachangelog.com); versioning: pre-1.0, minor bumps may break.
 
+## [Unreleased]
+
+### Added
+- Per-key model auto-defaults: with no model configured, the first configured
+  API key picks its provider's default model (`core.config.KEY_DEFAULT_MODELS`,
+  ordered free NVIDIA first, Anthropic last for decorrelation) — `/keys` alone
+  is now a working setup for every supported provider
+- `/model` with no argument shows the current resolved model, which layer set
+  it (flag/env/config/auto), and copy-pasteable examples for configured keys
+- `/model`/`/prober` validation at set time: warns (never blocks) on a missing
+  provider key, malformed `provider/model-id`, or single-segment
+  `openrouter/...`/`nvidia-nim/...` ids that would 404
+- `/keys` now chains into model choice: reports the model the critic will use,
+  or offers the saved key's default when the current model runs on another key
+
+### Fixed
+- `/model` and `/prober` no longer silently lose to a launch-time `--model`
+  flag or exported `COUNCIL_MODEL`/`COUNCIL_PROBER` on critic restart — a
+  console-set knob resolves from config.json only
+
 ## [0.1.0] — 2026-07-30
 
 First public release. An independent, execution-grounded reviewer for AI
diff --git a/install.sh b/install.sh
index f58ebb4..010054a 100755
--- a/install.sh
+++ b/install.sh
@@ -89,7 +89,7 @@ if [ ! -f "$ENV_FILE" ]; then
 #   GEMINI_API_KEY=...
 #   GROQ_API_KEY=gsk_...
 ENV
-  say "created $ENV_FILE — add a model key there (see comments inside)"
+  say "created $ENV_FILE — type /keys in the running council to fill it (guided, hidden input)"
 else
   say "keeping existing $ENV_FILE"
 fi
@@ -97,6 +97,7 @@ fi
 # --- done -------------------------------------------------------------------
 say ""
 say "installed. next steps:"
-say "  1. add a model key to $ENV_FILE (free: NVIDIA_API_KEY from build.nvidia.com)"
-say "  2. codecouncil /path/to/repo-you-code-in"
+say "  1. codecouncil /path/to/repo-you-code-in"
+say "  2. type /keys in the running council — guided key setup, hidden input"
+say "     (free: NVIDIA_API_KEY from build.nvidia.com; a model is picked automatically)"
 say "docs: https://github.com/adigo-pro/CodeCouncil#sixty-second-start"