chore(release): prepare v0.9.5

Author: Microck

CHANGELOG.md

@@ -7,6 +7,12 @@ Before `1.0.0`, breaking changes may still ship in minor releases.
 
 ## [Unreleased]
 
+## [0.9.5]
+
+### Fixed
+
+- Improved CLI error messages so authentication, validation, and network failures explain what was not completed and how to recover.
+
 ## [0.9.4]
 
 ### Fixed

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "kagi"
-version = "0.9.4"
+version = "0.9.5"
 edition = "2024"
 description = "Agent-native CLI for Kagi subscribers with JSON-first search output"
 license = "MIT"

Cargo.toml

@@ -79,7 +79,7 @@ It accepts:
 Bare `kagi auth` is intentionally interactive. In non-interactive environments it fails fast instead of hanging:
 
 ```text
-configuration error: kagi auth is interactive on TTYs; use `kagi auth set`, `kagi auth status`, or `kagi auth check` in non-interactive environments
+configuration error: `kagi auth` needs an interactive terminal. Use `kagi auth set`, `kagi auth status`, or `kagi auth check` in non-interactive environments
 ```
 
 That keeps CI, shell scripts, and other automation explicit.

docs/commands/auth.mdx

@@ -145,7 +145,7 @@ sh install-kagi.sh
 
 **Symptoms:**
 ```
-Config error: missing credentials: set KAGI_API_KEY or KAGI_SESSION_TOKEN (env), or add [auth] api_key/session_token to .kagi.toml
+configuration error: missing credentials: search was not sent. Set KAGI_API_KEY or KAGI_SESSION_TOKEN, or run `kagi auth set --api-key <key>` or `kagi auth set --session-token <token>`
 ```
 
 **Diagnostic:**
@@ -225,7 +225,7 @@ Error: Auth error: Kagi Search API request rejected: HTTP 403 Forbidden
 
 **Symptoms:**
 ```
-Config error: this command requires KAGI_API_TOKEN (env or .kagi.toml [auth.api_token])
+configuration error: this command requires KAGI_API_TOKEN. Set it in the environment or run `kagi auth set --api-token <token>`
 ```
 
 **Cause:** Trying to use paid API commands without API token
@@ -728,7 +728,7 @@ kagi auth check 2>&1 || echo "Auth check failed"
 | `command not found` | Not in PATH | Reload shell or add to PATH |
 | `Permission denied` | Not executable | `chmod +x *kagi*` |
 | `missing credentials` | No credential set | Set KAGI_SESSION_TOKEN, KAGI_API_KEY, or KAGI_API_TOKEN depending on the command |
-| `kagi auth is interactive on TTYs` | Bare `kagi auth` was run in CI, a pipe, or another non-interactive environment | Use `kagi auth set`, `kagi auth status`, or `kagi auth check` instead |
+| `` `kagi auth` needs an interactive terminal `` | Bare `kagi auth` was run in CI, a pipe, or another non-interactive environment | Use `kagi auth set`, `kagi auth status`, or `kagi auth check` instead |
 | `auth check failed` | Invalid token | Regenerate token in Kagi settings |
 | `403 Forbidden` | Auth issue | Check token validity |
 | `No results found` | Empty query result | Try different query |
@@ -762,7 +762,7 @@ If you've tried the solutions above and still have issues:
 **Symptom:**
 
 ```text
-configuration error: kagi auth is interactive on TTYs; use `kagi auth set`, `kagi auth status`, or `kagi auth check` in non-interactive environments
+configuration error: `kagi auth` needs an interactive terminal. Use `kagi auth set`, `kagi auth status`, or `kagi auth check` in non-interactive environments
 ```
 
 **Cause:**

docs/guides/troubleshooting.mdx

@@ -256,4 +256,4 @@ The *kagi* CLI is open source and welcomes contributions. See the [Development G
 
 ---
 
-*Last updated: June 2026 | kagi CLI v0.9.4*
+*Last updated: June 2026 | kagi CLI v0.9.5*

docs/index.mdx

@@ -37,7 +37,7 @@ Error: Network error: request to https://kagi.com/api/v1/search timed out after
 
 **Message:**
 ```
-Config error: missing credentials: set KAGI_API_KEY or KAGI_SESSION_TOKEN (env), or add [auth] api_key/session_token to .kagi.toml
+configuration error: missing credentials: search was not sent. Set KAGI_API_KEY or KAGI_SESSION_TOKEN, or run `kagi auth set --api-key <key>` or `kagi auth set --session-token <token>`
 ```
 
 **Meaning:** No authentication token is configured.
@@ -61,7 +61,7 @@ kagi auth check
 
 **Message:**
 ```
-Config error: this command requires KAGI_SESSION_TOKEN (env or .kagi.toml [auth.session_token])
+configuration error: this command requires KAGI_SESSION_TOKEN. Set it in the environment or run `kagi auth set --session-token <token>`
 ```
 
 **Meaning:** Command needs a session token, but you may have only an API key or legacy API token configured.
@@ -86,7 +86,7 @@ kagi assistant "Explain Rust ownership"
 
 **Message:**
 ```
-Config error: this command requires KAGI_API_TOKEN (env or .kagi.toml [auth.api_token])
+configuration error: this command requires KAGI_API_TOKEN. Set it in the environment or run `kagi auth set --api-token <token>`
 ```
 
 **Meaning:** Command needs API token, but you may have only session token configured.
@@ -218,7 +218,7 @@ kagi translate "Bonjour tout le monde"
 
 **Message:**
 ```
-Config error: this search option requires KAGI_SESSION_TOKEN (env or .kagi.toml [auth.session_token])
+configuration error: this search option requires KAGI_SESSION_TOKEN. Set it in the environment or run `kagi auth set --session-token <token>`
 ```
 
 **Meaning:** You used a session-only search option like `--lens`, `--time`, `--order`, `--verbatim`, or personalization flags without a configured session token. `--region`, `--from-date`, and `--to-date` can use the V1 Search API when `KAGI_API_KEY` is configured.

docs/reference/error-reference.mdx

@@ -433,7 +433,7 @@ Rust 1.86 added...
 Errors are plain text on stderr. Typical examples:
 
 ```text
-Config error: missing credentials: set KAGI_API_KEY or KAGI_SESSION_TOKEN (env), or add [auth] api_key/session_token to .kagi.toml
+configuration error: missing credentials: search was not sent. Set KAGI_API_KEY or KAGI_SESSION_TOKEN, or run `kagi auth set --api-key <key>` or `kagi auth set --session-token <token>`
 Auth error: invalid or expired Kagi session token
 Network error: request to Kagi timed out
 ```

docs/reference/output-contract.mdx

@@ -1,6 +1,6 @@
 {
   "name": "kagi-cli",
-  "version": "0.9.4",
+  "version": "0.9.5",
   "description": "Node wrapper that installs the native kagi CLI binary",
   "license": "MIT",
   "repository": {