Drswith · Drswith · May 13, 2026
diff --git a/README.md b/README.md
@@ -10,18 +10,18 @@
 [![bundle][bundle-src]][bundle-href]
 [![License][license-src]][license-href]
 
-Manage AI coding assistant CLIs from one lifecycle-focused command line.
+Install, inspect, update, uninstall, and run AI coding assistant CLIs from one agent-friendly command line.
 
 **English** | [简体中文](./README.zh-CN.md)
 
 </div>
 
-Quantex is a `human-friendly + agent-friendly` lifecycle CLI for AI coding agents. It gives Amp, Claude Code, Codex, Gemini, Kilo Code, Cursor, OpenCode, and other assistant CLIs a shared surface for installation, inspection, updates, removal, execution, and machine-readable automation. This README uses the shorter `qtx` form as the recommended entry point, while `quantex` remains the fully equivalent long command name.
+Quantex is a `human-friendly + agent-friendly` lifecycle CLI for AI coding assistants and terminal coding agents. Use one `qtx` surface to install, inspect, update, uninstall, run, and automate Codex CLI, Claude Code, Gemini CLI, Cursor CLI, OpenCode, Amp, Kilo Code, and other assistant CLIs with stable machine-readable output. This README uses the shorter `qtx` form as the recommended entry point, while `quantex` remains the fully equivalent long command name.
 
 ## Why Quantex
 
-- Manage multiple AI agents from one CLI: install, ensure, inspect, update, uninstall, and run.
-- Designed for scripts and coding agents: stable `--json`, `--output ndjson`, `--non-interactive`, and `--dry-run` contracts.
+- Manage multiple AI coding assistant CLIs from one lifecycle command: install, ensure, inspect, update, uninstall, and run.
+- Designed for scripts and coding agents: stable `--json`, `--output ndjson`, `--non-interactive`, and `--dry-run` contracts for machine-readable automation.
 - Tracks real install sources: `update --all` groups updates by recorded source instead of guessing from PATH alone.
 - Supports Quantex self-upgrade across Bun, npm, and standalone binary installs.
 

diff --git a/README.zh-CN.md b/README.zh-CN.md
@@ -16,12 +16,12 @@
 
 </div>
 
-Quantex 是一个 `human-friendly + agent-friendly` 的 agent lifecycle CLI。它帮你把 Amp、Claude Code、Codex、Gemini、Kilo Code、Cursor、OpenCode 等 AI 编程助手的生命周期操作统一到一组稳定命令里：人可以直接用，自动化脚本和 coding agent 也可以用结构化输出可靠调用。本文默认使用更短的 `qtx` 作为推荐入口，`quantex` 是完全等价的完整命令名。
+Quantex 是一个 `human-friendly + agent-friendly` 的 AI 编程助手 CLI lifecycle manager。它帮你把 Codex CLI、Claude Code、Gemini CLI、Cursor CLI、OpenCode、Amp、Kilo Code 等终端 coding agent 的安装、检查、更新、卸载、启动和自动化调用统一到一组稳定命令里：人可以直接用，脚本和 coding agent 也可以通过结构化输出可靠调用。本文默认使用更短的 `qtx` 作为推荐入口，`quantex` 是完全等价的完整命令名。
 
 ## 为什么用 Quantex
 
-- 一个入口管理多个 AI agent：安装、确保可用、查询状态、更新、卸载、启动。
-- 适合脚本和 agent 调用：支持 `--json`、`--output ndjson`、`--non-interactive`、`--dry-run` 等稳定契约。
+- 一个生命周期命令管理多个 AI 编程助手 CLI：安装、确保可用、查询状态、更新、卸载、启动。
+- 适合脚本和 agent 调用：支持 `--json`、`--output ndjson`、`--non-interactive`、`--dry-run` 等适合机器读取的稳定契约。
 - 记住真实安装来源：`update --all` 会优先按已记录来源分组更新，避免混合安装环境下误用更新方式。
 - 支持 Quantex 自升级：Bun、npm、独立二进制安装来源都有对应升级路径。
 

diff --git a/openspec/changes/improve-project-seo/.openspec.yaml b/openspec/changes/improve-project-seo/.openspec.yaml
@@ -0,0 +1,2 @@
+schema: spec-driven
+created: 2026-05-13
diff --git a/openspec/changes/improve-project-seo/design.md b/openspec/changes/improve-project-seo/design.md
@@ -0,0 +1,22 @@
+## Context
+
+Search discovery for a CLI package depends heavily on package registry metadata and the first visible README copy. Quantex already has accurate product documentation, but `package.json` lacks keywords and the opening copy can better include the terms users search for: AI coding assistant CLI, coding agent CLI, lifecycle management, install, inspect, update, uninstall, run, and machine-readable output.
+
+## Decision
+
+Make a narrow discoverability pass:
+
+- Update `package.json` `description` and `keywords`.
+- Update the README lead copy in English and Simplified Chinese.
+- Add an OpenSpec product-readme requirement that keeps future metadata/readme SEO edits accurate, natural, and within product scope.
+
+## Non-Goals
+
+- Do not add a website, generated landing page, ad copy, or root-level marketing document.
+- Do not change command behavior, supported-agent catalog data, install methods, or release metadata generation.
+- Do not frame Quantex as a workflow orchestration platform.
+
+## Risks
+
+- Overloaded keyword lists can look spammy and reduce trust. Keep keywords relevant to Quantex's actual lifecycle surface and supported CLI category.
+- README wording can drift into broader automation claims. Keep the copy tied to installation, inspection, updates, uninstall, execution, discovery, and structured output.
diff --git a/openspec/changes/improve-project-seo/proposal.md b/openspec/changes/improve-project-seo/proposal.md
@@ -0,0 +1,25 @@
+## Why
+
+Quantex's npm metadata currently has no keywords, and the README opening can be clearer about the searchable product category. Improving package and README discovery helps users find Quantex when searching for an agent lifecycle CLI for AI coding assistant tools.
+
+## What Changes
+
+- Add relevant npm keywords for AI coding assistant CLI lifecycle management.
+- Tighten the package description so search results immediately communicate Quantex's role.
+- Refine the English and Simplified Chinese README opening copy with natural discovery terms while preserving the `human-friendly + agent-friendly` positioning.
+- Keep the scope limited to product discoverability; do not change CLI behavior, command contracts, install methods, or supported-agent metadata.
+
+## Capabilities
+
+### New Capabilities
+
+- None.
+
+### Modified Capabilities
+
+- `product-readme`: product-facing README and package metadata should support clear discovery without keyword stuffing or scope expansion.
+
+## Impact
+
+- Affected files: `package.json`, `README.md`, `README.zh-CN.md`, and the `product-readme` OpenSpec delta.
+- No CLI behavior, API, schema, dependency, release workflow, or package contents change.
diff --git a/openspec/changes/improve-project-seo/specs/product-readme/spec.md b/openspec/changes/improve-project-seo/specs/product-readme/spec.md
@@ -0,0 +1,20 @@
+# product-readme Spec Delta
+
+## ADDED Requirements
+
+### Requirement: Product Metadata Supports Search Discovery
+
+Quantex package metadata and README opening copy SHALL use clear, relevant discovery terms for the product's actual category: an AI coding assistant CLI lifecycle manager for installation, inspection, update, uninstall, execution, discovery, and machine-readable automation.
+
+#### Scenario: User finds Quantex through package or repository search
+
+- **WHEN** a user sees Quantex in a package registry or repository search result
+- **THEN** the package description and README opening identify Quantex as a lifecycle CLI for AI coding assistant CLIs
+- **AND** package keywords remain directly related to Quantex, supported AI coding assistant CLI categories, lifecycle commands, and machine-readable agent usage
+- **AND** the metadata does not claim workflow orchestration, daemon, MCP server, or unrelated platform capabilities
+
+#### Scenario: Maintainer updates discoverability copy
+
+- **WHEN** a maintainer changes README opening copy or package search metadata
+- **THEN** the wording stays natural and user-readable instead of keyword-stuffed
+- **AND** the English and Simplified Chinese README openings preserve the same product positioning
diff --git a/openspec/changes/improve-project-seo/tasks.md b/openspec/changes/improve-project-seo/tasks.md
@@ -0,0 +1,13 @@
+## 1. SEO Metadata And README Copy
+
+- [x] 1.1 Add relevant npm package keywords.
+- [x] 1.2 Tighten the npm package description for search result clarity.
+- [x] 1.3 Improve the English README opening copy with natural discovery terms.
+- [x] 1.4 Mirror the same positioning in the Simplified Chinese README opening.
+
+## 2. OpenSpec And Validation
+
+- [x] 2.1 Add the product-readme spec delta for future discoverability edits.
+- [x] 2.2 Run `bun run openspec:status -- --change improve-project-seo`.
+- [x] 2.3 Run `bun run openspec:validate`.
+- [x] 2.4 Run required repository validation for changed files.
diff --git a/package.json b/package.json
@@ -1,8 +1,29 @@
 {
   "name": "quantex-cli",
   "version": "0.17.0",
-  "description": "A unified lifecycle CLI for installing, inspecting, updating, uninstalling, and launching popular AI coding assistants",
-  "keywords": [],
+  "description": "Agent-friendly lifecycle CLI for AI coding assistant CLIs: install, inspect, update, uninstall, run, and automate Codex, Claude Code, Gemini, Cursor, OpenCode, and more",
+  "keywords": [
+    "agent-cli",
+    "agent-lifecycle",
+    "ai",
+    "ai-agent",
+    "ai-coding",
+    "ai-coding-assistant",
+    "automation",
+    "claude-code",
+    "cli",
+    "codex",
+    "coding-agent",
+    "coding-assistant",
+    "cursor-cli",
+    "developer-tools",
+    "gemini-cli",
+    "machine-readable",
+    "opencode",
+    "qtx",
+    "quantex",
+    "self-upgrade"
+  ],
   "homepage": "https://github.com/Drswith/quantex-cli#readme",
   "bugs": "https://github.com/Drswith/quantex-cli/issues",
   "license": "Apache-2.0",