Fix search URL instead of deprecating it

Rather than deprecating `shopify search`, restore the original browser
experience by opening `https://shopify.dev/?search=<query>`. The command
is no longer marked deprecated, so it stays in the command listings and
behaves as it did before. `agent-search` remains the JSON-returning
command for programmatic/agent discovery.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: nelsonwittwer

.changeset/add-agent-search-command.md

@@ -4,4 +4,4 @@
 
 Add `shopify agent-search`, which queries the shopify.dev vector store and prints the most relevant documentation chunks as JSON to stdout. This makes it usable for programmatic and agent-driven discovery, and supports two optional filters: `--api-name` (for example `admin`, `storefront`, `hydrogen`) and `--api-version` (for example `2025-10`, `latest`, `current`). To download a full document verbatim, use `fetch-doc`.
 
-`shopify search` is now deprecated. Its behavior is unchanged — it still opens shopify.dev in your browser — but it prints a deprecation notice pointing to `agent-search`.
+Also fixes `shopify search` to open `https://shopify.dev/?search=<query>` so it once again opens shopify.dev with your query.

packages/cli/oclif.manifest.json

@@ -5711,9 +5711,6 @@
           "name": "query"
         }
       },
-      "deprecationOptions": {
-        "to": "agent-search"
-      },
       "description": "Starts a search on shopify.dev.",
       "enableJsonFlag": false,
       "examples": [
@@ -5728,7 +5725,6 @@
       "pluginAlias": "@shopify/cli",
       "pluginName": "@shopify/cli",
       "pluginType": "core",
-      "state": "deprecated",
       "strict": true,
       "usage": "search [query]"
     },

packages/cli/src/cli/commands/search.test.ts

@@ -5,12 +5,6 @@ import {Args} from '@oclif/core'
 export default class Search extends Command {
   static description = 'Starts a search on shopify.dev.'
 
-  // Deprecated in favor of `agent-search`, which returns JSON for programmatic use.
-  // The browser behavior below is intentionally preserved so existing usage doesn't
-  // break; oclif emits a runtime deprecation warning pointing to `agent-search`.
-  static state = 'deprecated'
-  static deprecationOptions = {to: 'agent-search'}
-
   static usage = `search [query]`
 
   static examples = [

packages/cli/src/cli/commands/search.ts

@@ -8,12 +8,12 @@ describe('searchService', () => {
   test('the right URL is open in the system when a query is passed', async () => {
     await searchService('deploy app')
 
-    expect(openURL).toBeCalledWith('https://shopify.dev?search=deploy+app')
+    expect(openURL).toBeCalledWith('https://shopify.dev/?search=deploy+app')
   })
 
   test('the right URL is open in the system when a query is not passed', async () => {
     await searchService()
 
-    expect(openURL).toBeCalledWith('https://shopify.dev?search=')
+    expect(openURL).toBeCalledWith('https://shopify.dev/?search=')
   })
 })

packages/cli/src/cli/services/commands/search.test.ts

@@ -3,5 +3,5 @@ import {openURL} from '@shopify/cli-kit/node/system'
 export async function searchService(query?: string) {
   const searchParams = new URLSearchParams()
   searchParams.append('search', query ?? '')
-  await openURL(`https://shopify.dev?${searchParams.toString()}`)
+  await openURL(`https://shopify.dev/?${searchParams.toString()}`)
 }

packages/cli/src/cli/services/commands/search.ts

@@ -92,6 +92,7 @@
 │  ├─ uninstall
 │  ├─ unlink
 │  └─ update
+├─ search
 ├─ store
 │  ├─ auth
 │  └─ execute