refactor: apply thermo-nuclear quality review fixes

.github/workflows/npm-publish.yml

@@ -49,4 +49,4 @@ jobs:
       - name: Publish package
         if: vars.NPM_PUBLISH_ENABLED == 'true'
         working-directory: npm
-        run: npm publish --access public --provenance=false
+        run: npm publish --access public --provenance

.github/workflows/release.yml

@@ -326,7 +326,7 @@ jobs:
             end
 
             test do
-              assert_match "Usage: kagi <COMMAND>", shell_output("#{bin}/kagi --help")
+              assert_match "Usage: kagi [OPTIONS] [COMMAND]", shell_output("#{bin}/kagi --help")
             end
           end
           EOF

README.md

@@ -326,7 +326,7 @@ kagi assistant --attach ./a.jpg --attach ./b.pdf "tell me everything about this
 use assistant as a terminal chat client:
 
 ```bash
-kagi assistant repl --model gpt-5-mini --export ./assistant-transcript.json
+kagi assistant repl --model gpt-5-4-nano --export ./assistant-transcript.json
 ```
 
 ask assistant about a page directly:
@@ -349,7 +349,7 @@ manage custom assistants:
 ```bash
 kagi assistant custom list
 kagi assistant custom get "Release Notes"
-kagi assistant custom create "Release Notes" --model gpt-5-mini --web-access --lens 2 --instructions "Focus on release diffs and migration notes."
+kagi assistant custom create "Release Notes" --model gpt-5-4-nano --web-access --lens 2 --instructions "Focus on release diffs and migration notes."
 kagi assistant custom update "Release Notes" --bang-trigger relnotes --no-personalized
 ```
 

docs/SKILL.md

@@ -178,7 +178,7 @@ kagi assistant "Explain quantum computing"
 kagi assistant --thread-id "<thread-id>" "Give me an example"
 
 # Use a saved assistant profile with prompt overrides
-kagi assistant --assistant research --model gpt-5-mini --web-access --no-personalized "Summarize the latest Rust release"
+kagi assistant --assistant research --model gpt-5-4-nano --web-access --no-personalized "Summarize the latest Rust release"
 
 # Stream markdown deltas as they arrive
 kagi assistant --stream "Explain quantum computing"
@@ -211,7 +211,7 @@ kagi assistant custom list
 kagi assistant custom get "Release Notes"
 
 # Create a custom assistant
-kagi assistant custom create "Release Notes" --model gpt-5-mini --web-access --lens 2 --instructions "Focus on release diffs and migrations."
+kagi assistant custom create "Release Notes" --model gpt-5-4-nano --web-access --lens 2 --instructions "Focus on release diffs and migrations."
 
 # Update an existing custom assistant
 kagi assistant custom update "Release Notes" --bang-trigger relnotes --no-personalized

docs/commands/assistant.mdx

@@ -108,7 +108,7 @@ Possible values:
 Override the model slug for a single prompt.
 
 ```bash
-kagi assistant --model gpt-5-mini "reply with only the model name"
+kagi assistant --model gpt-5-4-nano "reply with only the model name"
 ```
 
 #### `--lens <LENS_ID>`
@@ -132,7 +132,7 @@ Force Kagi personalizations on or off for a single prompt.
 `kagi assistant repl` starts a terminal chat loop that keeps the latest Assistant thread id and sends each prompt back into the same conversation.
 
 ```bash
-kagi assistant repl --model gpt-5-mini --export ./assistant-transcript.json
+kagi assistant repl --model gpt-5-4-nano --export ./assistant-transcript.json
 ```
 
 REPL commands:
@@ -224,7 +224,7 @@ Supported options:
 ```bash
 kagi assistant custom create "Release Notes" \
   --bang-trigger release \
-  --model gpt-5-mini \
+  --model gpt-5-4-nano \
   --web-access \
   --instructions "Summarize release posts with a changelog-first bias."
 ```
@@ -328,7 +328,7 @@ Prompt mode returns:
     "id": "assistant-1",
     "name": "Research",
     "invoke_profile": "research",
-    "model": "gpt-5-mini",
+    "model": "gpt-5-4-nano",
     "bang_trigger": "research",
     "internet_access": true,
     "built_in": false,
@@ -342,7 +342,7 @@ Prompt mode returns:
 Start a thread, capture the id, continue it, then export it:
 
 ```bash
-RESPONSE=$(kagi assistant --model gpt-5-mini "plan a calm terminal research session in 3 bullets")
+RESPONSE=$(kagi assistant --model gpt-5-4-nano "plan a calm terminal research session in 3 bullets")
 THREAD_ID=$(printf '%s' "$RESPONSE" | jq -r '.thread.id')
 
 printf '%s\n' "$RESPONSE" | jq -r '.message.markdown'

docs/demos.md

@@ -33,7 +33,7 @@ The current demo commands are:
 - `kagi ask-page https://rust-lang.org/ "What is this page about in one sentence?" | jq -M ...`
 - `kagi assistant "plan a private obsidian workflow for cafe work. give me 3 setup tips and a short checklist." | jq -M ...`
 - `kagi translate "Bonjour tout le monde" --to ja | jq -M ...`
-- `RESPONSE=$(kagi assistant --model gpt-5-mini "..."); THREAD_ID=...; kagi assistant --thread-id "$THREAD_ID" "..."; kagi assistant thread export "$THREAD_ID"`
+- `RESPONSE=$(kagi assistant --model gpt-5-4-nano "..."); THREAD_ID=...; kagi assistant --thread-id "$THREAD_ID" "..."; kagi assistant thread export "$THREAD_ID"`
 - `kagi lens list | jq -M ...`
 - `kagi bang custom list | jq -M ...`
 - `kagi redirect list | jq -M ...`

docs/project/demos.mdx

@@ -64,7 +64,7 @@ The current demo commands are:
 - `kagi news --category tech --limit 1 | jq -M ...`
 - `kagi ask-page https://rust-lang.org/ "What is this page about in one sentence?" | jq -M ...`
 - `kagi assistant "plan a private obsidian workflow for cafe work. give me 3 setup tips and a short checklist." | jq -M ...`
-- `RESPONSE=$(kagi assistant --model gpt-5-mini "..."); THREAD_ID=...; kagi assistant --thread-id "$THREAD_ID" "..."; kagi assistant thread export "$THREAD_ID"`
+- `RESPONSE=$(kagi assistant --model gpt-5-4-nano "..."); THREAD_ID=...; kagi assistant --thread-id "$THREAD_ID" "..."; kagi assistant thread export "$THREAD_ID"`
 - `kagi translate "Bonjour tout le monde" --to ja | jq -M ...`
 
 ```bash

docs/reference/output-contract.mdx

@@ -176,7 +176,7 @@ Subscriber mode:
     "id": "assistant-1",
     "name": "Research",
     "invoke_profile": "research",
-    "model": "gpt-5-mini",
+    "model": "gpt-5-4-nano",
     "bang_trigger": "research",
     "internet_access": true,
     "built_in": false,
@@ -195,7 +195,7 @@ Subscriber mode:
   "internet_access": true,
   "selected_lens": "",
   "personalizations": false,
-  "base_model": "gpt-5-mini",
+  "base_model": "gpt-5-4-nano",
   "custom_instructions": "Focus on changelogs first.",
   "delete_supported": true
 }

packaging/homebrew/Formula/kagi.rb

@@ -1,30 +1,30 @@
 class Kagi < Formula
   desc "Agent-native Rust CLI for Kagi subscribers with JSON-first output"
   homepage "https://github.com/Microck/kagi-cli"
-  version "0.1.6"
+  version "0.9.0"
   license "MIT"
 
   on_macos do
     if Hardware::CPU.arm?
-      url "https://github.com/Microck/kagi-cli/releases/download/v0.1.6/kagi-v0.1.6-aarch64-apple-darwin.tar.gz"
-      sha256 "bbd5c4093e459357ec1b8a1162d043c776ae93732b17412dd434af446bd71d52"
+      url "https://github.com/Microck/kagi-cli/releases/download/v0.9.0/kagi-v0.9.0-aarch64-apple-darwin.tar.gz"
+      sha256 "d5d4daf70a730d7d98f340927c6cf12e109c4e910564469593bef50d12f553f5"
     end
 
     if Hardware::CPU.intel?
-      url "https://github.com/Microck/kagi-cli/releases/download/v0.1.6/kagi-v0.1.6-x86_64-apple-darwin.tar.gz"
-      sha256 "af69180d48e2019938c4088ffc276e373dda81685b9b1b15bdfbeb30ca2e441e"
+      url "https://github.com/Microck/kagi-cli/releases/download/v0.9.0/kagi-v0.9.0-x86_64-apple-darwin.tar.gz"
+      sha256 "f7d7ecb04d13bdf6be33cb4f1a88a50d2139e8e1123d8f388c4d89c9a9d9b966"
     end
   end
 
   on_linux do
     if Hardware::CPU.arm?
-      url "https://github.com/Microck/kagi-cli/releases/download/v0.1.6/kagi-v0.1.6-aarch64-unknown-linux-gnu.tar.gz"
-      sha256 "0b7902f8a39e14342e1c7e5d712b28b8de8bf3619aaabd5cd044d39ca54025af"
+      url "https://github.com/Microck/kagi-cli/releases/download/v0.9.0/kagi-v0.9.0-aarch64-unknown-linux-gnu.tar.gz"
+      sha256 "a22fde549b32402e062bb46aa43ce968ec7d4432ff7a1ee37e4d45ce739b1cff"
     end
 
     if Hardware::CPU.intel?
-      url "https://github.com/Microck/kagi-cli/releases/download/v0.1.6/kagi-v0.1.6-x86_64-unknown-linux-gnu.tar.gz"
-      sha256 "dda9322bba71d3cb109bc610dfd2701675523573341bbf913c620f02c2c0cb7c"
+      url "https://github.com/Microck/kagi-cli/releases/download/v0.9.0/kagi-v0.9.0-x86_64-unknown-linux-gnu.tar.gz"
+      sha256 "09bd758be6f374384aa73c1d6d22e92bcfced40537d06ea832dfb80a659dea02"
     end
   end
 
@@ -33,6 +33,6 @@ def install
   end
 
   test do
-    assert_match "Usage: kagi <COMMAND>", shell_output("#{bin}/kagi --help")
+    assert_match "Usage: kagi [OPTIONS] [COMMAND]", shell_output("#{bin}/kagi --help")
   end
 end

packaging/scoop/kagi.json

@@ -1,12 +1,12 @@
 {
-  "version": "0.1.6",
+  "version": "0.9.0",
   "description": "Agent-native Rust CLI for Kagi subscribers with JSON-first output.",
   "homepage": "https://github.com/Microck/kagi-cli",
   "license": "MIT",
   "architecture": {
     "64bit": {
-      "url": "https://github.com/Microck/kagi-cli/releases/download/v0.1.6/kagi-v0.1.6-x86_64-pc-windows-msvc.zip",
-      "hash": "2daa51118d076b4593453feba61e703183aa5f6bc0075c43aaa579d1dcdf5159"
+      "url": "https://github.com/Microck/kagi-cli/releases/download/v0.9.0/kagi-v0.9.0-x86_64-pc-windows-msvc.zip",
+      "hash": "6474bae2605f1b41c1bfd9072f7707e8aac35d27fdf54e6bd1d3285675ce1d1e"
     }
   },
   "bin": "kagi.exe",