chore(release): prepare v0.10.0

Author: Microck

CHANGELOG.md

@@ -7,6 +7,21 @@ Before `1.0.0`, breaking changes may still ship in minor releases.
 
 ## [Unreleased]
 
+## [0.10.0]
+
+### Added
+
+- `kagi search` and `kagi batch` now preserve related search metadata from the Search API in structured output.
+- `kagi extract` now supports `--format json` and `--format compact` to expose the full Extract API envelope, including retained link metadata when returned by Kagi.
+
+### Changed
+
+- Assistant thread output now uses folders instead of tags, matching Kagi's current thread organization model.
+
+### Fixed
+
+- `kagi translate` now reports inactive subscription failures with a clearer message when Kagi Translate rejects access.
+
 ## [0.9.6]
 
 ### Fixed

Cargo.lock

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

Cargo.toml

@@ -266,7 +266,7 @@ Prompt mode returns:
     "saved": false,
     "shared": false,
     "branch_id": "00000000-0000-4000-0000-000000000000",
-    "tag_ids": []
+    "folder_ids": []
   },
   "message": {
     "id": "msg-1",
@@ -297,7 +297,7 @@ Prompt mode returns:
     "version": "202603171911.stage.707e740",
     "trace": "trace-123"
   },
-  "tags": [],
+  "folders": [],
   "threads": [
     {
       "id": "thread-1",
@@ -306,7 +306,7 @@ Prompt mode returns:
       "snippet": "Hello",
       "saved": false,
       "shared": false,
-      "tag_ids": []
+      "folder_ids": []
     }
   ],
   "pagination": {

docs/commands/assistant.mdx

@@ -10,14 +10,14 @@ Extract the readable content of a web page as markdown using Kagi's Extract API.
 ## Synopsis
 
 ```bash
-kagi extract <URL>
+kagi extract <URL> [--format markdown|json|compact]
 ```
 
 ## Description
 
-The `kagi extract` command sends one HTTPS URL to Kagi's v1 Extract API and prints the extracted page markdown to stdout. It is useful when a search result, article, or documentation page needs full-page text instead of a search snippet.
+The `kagi extract` command sends one HTTPS URL to Kagi's v1 Extract API and prints the extracted page markdown to stdout by default. It is useful when a search result, article, or documentation page needs full-page text instead of a search snippet.
 
-The command uses JSON mode internally because that is the stable envelope returned by the API, then prints the first page's `markdown` field. If Kagi returns no page markdown, the CLI reports the Extract API error details and trace id when available.
+The command uses JSON mode internally because that is the stable envelope returned by the API, then prints the first page's `markdown` field. Use `--format json` or `--format compact` to print the full response envelope, including retained link metadata when Kagi returns it. If Kagi returns no page markdown, the CLI reports the Extract API error details and trace id when available.
 
 ## Authentication
 
@@ -37,6 +37,16 @@ kagi extract "https://example.com/article"
 
 Only `https://` URLs with a valid host are accepted.
 
+### `--format <FORMAT>`
+
+Output format. Default: `markdown`.
+
+Supported values:
+
+- `markdown` - print the first page's markdown content only
+- `json` - print the full Extract API response envelope
+- `compact` - print the full response envelope as compact JSON
+
 ## Output
 
 The command prints markdown directly:
@@ -47,6 +57,30 @@ The command prints markdown directly:
 Extracted page content...
 ```
 
+With `--format json`, the command prints the full response envelope:
+
+```json
+{
+  "meta": {
+    "trace": "trace-1",
+    "node": "test",
+    "ms": 12
+  },
+  "data": [
+    {
+      "url": "https://example.com/article",
+      "markdown": "# Article title\n\nExtracted page content...",
+      "links": [
+        {
+          "text": "Source",
+          "url": "https://example.com/"
+        }
+      ]
+    }
+  ]
+}
+```
+
 ## Examples
 
 ### Save an Article
@@ -61,6 +95,12 @@ kagi extract "https://example.com/article" > article.md
 kagi extract "https://example.com/article" | sed -n '1,80p'
 ```
 
+### Inspect Retained Links
+
+```bash
+kagi extract "https://example.com/article" --format json | jq '.data[0].links'
+```
+
 ## Exit Codes
 
 | Code | Meaning |

docs/commands/extract.mdx

@@ -339,6 +339,9 @@ kagi search "iran" --news --time day --format pretty
 # Extract URLs
 kagi search "rust" | jq -r '.data[].url'
 
+# Inspect related search metadata when the API returns it
+kagi search "rust" | jq '.related_searches'
+
 # Get first result
 kagi search "rust" | jq -r '.data[0].title'
 

docs/commands/search.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.6*
+*Last updated: June 2026 | kagi CLI v0.10.0*

docs/index.mdx

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