From ef951b26b444668d2bb599e46511803433eea6ba Mon Sep 17 00:00:00 2001
From: Developers Digest <124798203+developersdigest@users.noreply.github.com>
Date: Fri, 18 Sep 2026 13:01:07 -0400
Subject: [PATCH] feat: show tool inspection commands in search results

---
 src/__tests__/alexandria-beta.test.ts | 3 +++
 src/commands/search.ts                | 7 ++++++-
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/src/__tests__/alexandria-beta.test.ts b/src/__tests__/alexandria-beta.test.ts
index 890ab2cc36..d974de728c 100644
--- a/src/__tests__/alexandria-beta.test.ts
+++ b/src/__tests__/alexandria-beta.test.ts
@@ -413,6 +413,9 @@ it('preserves mixed search results, tools and billing metadata', async () => {
   const readable = await cli(['search', 'pizza hut']);
   expect(readable.stdout).toContain('=== Alexandria Tools ===');
   expect(readable.stdout).toContain('series/observations');
+  expect(readable.stdout).toContain(
+    'Inspect: npx firecrawl-cli@alexandria list fred/series/observations --json'
+  );
 });
 
 it('sends provider calls to Scrape with a stable retry ID and preserves the receipt', async () => {
diff --git a/src/commands/search.ts b/src/commands/search.ts
index 01b079542d..26bfe8bc0f 100644
--- a/src/commands/search.ts
+++ b/src/commands/search.ts
@@ -292,7 +292,12 @@ function formatSearchReadable(
           : undefined;
       const title = tool.label ?? tool.name ?? address ?? tool.id ?? 'Tool';
       lines.push(String(title));
-      if (address) lines.push(`  Tool: ${address}`);
+      if (address) {
+        lines.push(`  Tool: ${address}`);
+        lines.push(
+          `  Inspect: npx firecrawl-cli@alexandria list ${address} --json`
+        );
+      }
       if (typeof tool.description === 'string')
         lines.push(`  ${clipPassage(tool.description)}`);
       if (typeof tool.creditsCost === 'number')