From 07d7982b0a8406602f593c9cca9c947fb0b3ec24 Mon Sep 17 00:00:00 2001
From: Microck <contact@micr.dev>
Date: Thu, 8 Oct 2026 19:55:39 +0000
Subject: [PATCH] docs: clarify built-in assistant model restriction

---
 CHANGELOG.md                             | 2 ++
 Cargo.lock                               | 2 +-
 Cargo.toml                               | 2 +-
 docs/content/docs/commands/assistant.mdx | 2 +-
 docs/content/docs/index.mdx              | 2 +-
 npm/package.json                         | 2 +-
 6 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 903e5ab..fba22f1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,7 @@
 ## [Unreleased]
 
+## [0.21.0]
+
 ### Breaking
 
 - `kagi assistant` and `kagi ask-page` JSON output no longer has `meta.version`, `meta.trace`, `message.reply_html`, or `message.trace_id`, because Kagi's v2 Assistant API returns markdown only. `message.id` is now the assistant turn id.
diff --git a/Cargo.lock b/Cargo.lock
index 8a678ca..4937b22 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -1065,7 +1065,7 @@ dependencies = [
 
 [[package]]
 name = "kagi"
-version = "0.20.1"
+version = "0.21.0"
 dependencies = [
  "clap",
  "clap_complete",
diff --git a/Cargo.toml b/Cargo.toml
index e308397..1baaa7b 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "kagi"
-version = "0.20.1"
+version = "0.21.0"
 edition = "2024"
 description = "Agent-native CLI for Kagi subscribers with JSON-first search output"
 license = "MIT"
diff --git a/docs/content/docs/commands/assistant.mdx b/docs/content/docs/commands/assistant.mdx
index d43bd08..e0e024f 100644
--- a/docs/content/docs/commands/assistant.mdx
+++ b/docs/content/docs/commands/assistant.mdx
@@ -143,7 +143,7 @@ Possible values:
 
 #### `--model <MODEL>`
 
-Override the model slug for a single prompt.
+Override the model slug for a single prompt. This option cannot be combined with `--assistant <built-in>` because built-in assistants always use their own model.
 
 ```bash
 kagi assistant --model gpt-5-4-nano "reply with only the model name"
diff --git a/docs/content/docs/index.mdx b/docs/content/docs/index.mdx
index a0033fc..1921648 100644
--- a/docs/content/docs/index.mdx
+++ b/docs/content/docs/index.mdx
@@ -259,4 +259,4 @@ The *kagi* CLI is open source and welcomes contributions. See the [Development G
 
 ---
 
-*Last updated: September 2026 | kagi CLI v0.20.1*
+*Last updated: October 2026 | kagi CLI v0.21.0*
diff --git a/npm/package.json b/npm/package.json
index 14f4bac..5473c3f 100644
--- a/npm/package.json
+++ b/npm/package.json
@@ -1,6 +1,6 @@
 {
   "name": "kagi-cli",
-  "version": "0.20.1",
+  "version": "0.21.0",
   "description": "Node wrapper that installs the native kagi CLI binary",
   "license": "MIT",
   "repository": {