@audienti/cli 0.1.104 → 0.1.105

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to the Audienti CLI are documented here.
 
 ## [Unreleased]
 
+## [0.1.105] - 2026-10-07
+
+### Added
+
+- `audienti find <name>` finds people, companies, experiments and users in the account by name (a person also matches by company name), at most 5 of each. It uses the same search as the web Jump to pop-up (Cmd+K), through `GET /api/v1/accounts/:account_id/jump_to?q=<name>`.
+
 ## [0.1.104] - 2026-10-07
 
 ### Changed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@audienti/cli",
-  "version": "0.1.104",
+  "version": "0.1.105",
   "description": "Agent-first command-line client for Audienti.",
   "type": "module",
   "bin": {

package/src/api-client.js

@@ -470,6 +470,10 @@ export class AudientiClient {
     });
   }
 
+  jumpTo(accountId, query) {
+    return this.requestJson(accountPath(accountId, ["jump_to"], { q: query }));
+  }
+
   tags(accountId) {
     return this.requestJson(accountPath(accountId, ["tags"]));
   }

package/src/cli.js

@@ -412,6 +412,7 @@ async function dispatch(argv, context) {
   if (normalizedResource === "reply-alerts") return replyAlertsCommand(action, rest, context);
   if (normalizedResource === "brand-profile") return brandProfileCommand(action, rest, context, { accountOverride });
   if (normalizedResource === "payment") return paymentCommand(action, rest, context, { accountOverride });
+  if (normalizedResource === "find") return findByName([action, ...rest].filter((value) => value !== undefined), context, { accountOverride });
   if (normalizedResource === "tags" && action === "list") return tagsList(rest, context, { accountOverride });
   if (normalizedResource === "tags" && action === "show") return tagsShow(rest, context, { accountOverride });
   if (normalizedResource === "tasks" && ["list", "manage"].includes(action)) return tasksList(rest, context, { accountOverride });
@@ -3012,6 +3013,19 @@ function writeBrandProfile(profile, context) {
   writeLine(context.stdout, `Do not use: ${display(profile?.do_not_use, "-")}`);
 }
 
+// Same search as the web ⌘K "Jump to" pop-up: people, companies, experiments and users by name, at most 5 of each.
+async function findByName(args, context, { accountOverride } = {}) {
+  const { values, positionals } = parseCommandArgs(args, jsonOptions());
+  const query = positionals.join(" ").trim();
+  if (!query) throw new CommandError("Usage: audienti find <name> [--json] [--account <acct_id>]");
+
+  const { client, accountId } = await requireAccountContext(context, { accountOverride });
+  const payload = await client.jumpTo(accountId, query);
+  if (values.json) return writeJson(context.stdout, payload);
+
+  renderFindResults(payload, context);
+}
+
 async function tagsList(args, context, { accountOverride } = {}) {
   const { values, positionals } = parseCommandArgs(args, jsonOptions());
   if (positionals.length > 0) throw new CommandError("Usage: audienti tags list [--json] [--account <acct_id>]");
@@ -7264,6 +7278,19 @@ function routingRuleTargetLabel(rule) {
     "-";
 }
 
+function renderFindResults(payload, context) {
+  const groups = [["People", payload?.people], ["Companies", payload?.companies], ["Experiments", payload?.experiments], ["Users", payload?.users]];
+  if (groups.every(([, rows]) => !Array.isArray(rows) || rows.length === 0)) return writeLine(context.stdout, "Nothing found.");
+
+  for (const [title, rows] of groups) {
+    if (!Array.isArray(rows) || rows.length === 0) continue;
+    writeLine(context.stdout, title);
+    for (const row of rows) {
+      writeLine(context.stdout, ["  " + display(row.name), display(row.detail, ""), display(row.path, "")].join("\t"));
+    }
+  }
+}
+
 function renderTags(tags, context) {
   if (!Array.isArray(tags) || tags.length === 0) return writeLine(context.stdout, "No tags found.");
 
@@ -10603,6 +10630,7 @@ const HELP_TOPICS = new Map([
     "    audienti lists bulk-add-tag --tag <tag> <list_id> [list_id...]",
     "    audienti lists merge <list_id> <list_id>",
     "    audienti lists export <list_id> [--output <file.csv>]",
+    "    audienti find <name>",
     "    audienti tags list",
     "    audienti tags show <tag>",
     "    audienti tasks list [--status open]",
@@ -12025,6 +12053,21 @@ const HELP_TOPICS = new Map([
     "  POST /api/v1/accounts/:account_id/company_rules/apply_all.json"
   ].join("\n")],
 
+  ["find", [
+    "Usage:",
+    "  audienti find <name> [--json]",
+    "",
+    "Status: implemented",
+    "",
+    "Purpose:",
+    "  Find people, companies, experiments and users in the account by name, at most 5 of each.",
+    "  A person also matches by company name.",
+    "  Uses the same search as the web Jump to pop-up (Cmd+K). Needs at least 2 characters.",
+    "",
+    "API:",
+    "  GET /api/v1/accounts/:account_id/jump_to?q=<name>"
+  ].join("\n")],
+
   ["tags", [
     "Usage:",
     "  audienti tags list [--json]",