feat(profile): add profile command to surface CPU profiling data

plugins/sentry-cli/skills/sentry-cli/SKILL.md

@@ -500,6 +500,31 @@ sentry log view my-org/backend 968c763c740cfda8b6728f27fb9e9b01
 sentry log list --json | jq '.[] | select(.level == "error")'
 ```
 
+### Profile
+
+Analyze CPU profiling data
+
+#### `sentry profile list <target>`
+
+List transactions with profiling data
+
+**Flags:**
+- `--period <value> - Time period: 1h, 24h, 7d, 14d, 30d - (default: "24h")`
+- `-n, --limit <value> - Maximum number of transactions to return - (default: "20")`
+- `--json - Output as JSON`
+- `-w, --web - Open in browser`
+
+#### `sentry profile view <args...>`
+
+View CPU profiling analysis for a transaction
+
+**Flags:**
+- `--period <value> - Stats period: 1h, 24h, 7d, 14d, 30d - (default: "24h")`
+- `-n, --limit <value> - Number of hot paths to show (max 20) - (default: "10")`
+- `--allFrames - Include library/system frames (default: user code only)`
+- `--json - Output as JSON`
+- `-w, --web - Open in browser`
+
 ### Issues
 
 List issues in a project

src/app.ts

@@ -17,6 +17,7 @@ import { logRoute } from "./commands/log/index.js";
 import { listCommand as logListCommand } from "./commands/log/list.js";
 import { orgRoute } from "./commands/org/index.js";
 import { listCommand as orgListCommand } from "./commands/org/list.js";
+import { profileRoute } from "./commands/profile/index.js";
 import { projectRoute } from "./commands/project/index.js";
 import { listCommand as projectListCommand } from "./commands/project/list.js";
 import { CLI_VERSION } from "./lib/constants.js";
@@ -34,6 +35,7 @@ export const routes = buildRouteMap({
     issue: issueRoute,
     event: eventRoute,
     log: logRoute,
+    profile: profileRoute,
     api: apiCommand,
     issues: issueListCommand,
     orgs: orgListCommand,

src/commands/event/view.ts

@@ -5,7 +5,7 @@
  */
 
 import type { SentryContext } from "../../context.js";
-import { findProjectsBySlug, getEvent } from "../../lib/api-client.js";
+import { getEvent } from "../../lib/api-client.js";
 import {
   ProjectSpecificationType,
   parseOrgProjectArg,
@@ -15,7 +15,11 @@ import { openInBrowser } from "../../lib/browser.js";
 import { buildCommand } from "../../lib/command.js";
 import { ContextError, ValidationError } from "../../lib/errors.js";
 import { formatEventDetails, writeJson } from "../../lib/formatters/index.js";
-import { resolveOrgAndProject } from "../../lib/resolve-target.js";
+import {
+  type ResolvedTarget,
+  resolveOrgAndProject,
+  resolveProjectBySlug,
+} from "../../lib/resolve-target.js";
 import { buildEventSearchUrl } from "../../lib/sentry-urls.js";
 import { getSpanTreeLines } from "../../lib/span-tree.js";
 import type { SentryEvent, Writer } from "../../types/index.js";
@@ -95,57 +99,10 @@ export function parsePositionalArgs(args: string[]): {
 
 /**
  * Resolved target type for event commands.
+ * Uses ResolvedTarget from resolve-target.ts.
  * @internal Exported for testing
  */
-export type ResolvedEventTarget = {
-  org: string;
-  project: string;
-  orgDisplay: string;
-  projectDisplay: string;
-  detectedFrom?: string;
-};
-
-/**
- * Resolve target from a project search result.
- *
- * Searches for a project by slug across all accessible organizations.
- * Throws if no project found or if multiple projects found in different orgs.
- *
- * @param projectSlug - Project slug to search for
- * @param eventId - Event ID (used in error messages)
- * @returns Resolved target with org and project info
- * @throws {ContextError} If no project found
- * @throws {ValidationError} If project exists in multiple organizations
- *
- * @internal Exported for testing
- */
-export async function resolveFromProjectSearch(
-  projectSlug: string,
-  eventId: string
-): Promise<ResolvedEventTarget> {
-  const found = await findProjectsBySlug(projectSlug);
-  if (found.length === 0) {
-    throw new ContextError(`Project "${projectSlug}"`, USAGE_HINT, [
-      "Check that you have access to a project with this slug",
-    ]);
-  }
-  if (found.length > 1) {
-    const orgList = found.map((p) => `  ${p.orgSlug}/${p.slug}`).join("\n");
-    throw new ValidationError(
-      `Project "${projectSlug}" exists in multiple organizations.\n\n` +
-        `Specify the organization:\n${orgList}\n\n` +
-        `Example: sentry event view <org>/${projectSlug} ${eventId}`
-    );
-  }
-  // Safe assertion: length is exactly 1 after the checks above
-  const foundProject = found[0] as (typeof found)[0];
-  return {
-    org: foundProject.orgSlug,
-    project: foundProject.slug,
-    orgDisplay: foundProject.orgSlug,
-    projectDisplay: foundProject.slug,
-  };
-}
+export type ResolvedEventTarget = ResolvedTarget;
 
 export const viewCommand = buildCommand({
   docs: {
@@ -206,7 +163,10 @@ export const viewCommand = buildCommand({
         break;
 
       case ProjectSpecificationType.ProjectSearch:
-        target = await resolveFromProjectSearch(parsed.projectSlug, eventId);
+        target = await resolveProjectBySlug(parsed.projectSlug, {
+          usageHint: USAGE_HINT,
+          contextValue: eventId,
+        });
         break;
 
       case ProjectSpecificationType.OrgAll:

src/commands/log/view.ts

@@ -6,12 +6,15 @@
 
 import { buildCommand } from "@stricli/core";
 import type { SentryContext } from "../../context.js";
-import { findProjectsBySlug, getLog } from "../../lib/api-client.js";
+import { getLog } from "../../lib/api-client.js";
 import { parseOrgProjectArg } from "../../lib/arg-parsing.js";
 import { openInBrowser } from "../../lib/browser.js";
 import { ContextError, ValidationError } from "../../lib/errors.js";
 import { formatLogDetails, writeJson } from "../../lib/formatters/index.js";
-import { resolveOrgAndProject } from "../../lib/resolve-target.js";
+import {
+  resolveOrgAndProject,
+  resolveProjectBySlug,
+} from "../../lib/resolve-target.js";
 import { buildLogsUrl } from "../../lib/sentry-urls.js";
 import type { DetailedSentryLog, Writer } from "../../types/index.js";
 
@@ -68,46 +71,6 @@ export type ResolvedLogTarget = {
   detectedFrom?: string;
 };
 
-/**
- * Resolve target from a project search result.
- *
- * Searches for a project by slug across all accessible organizations.
- * Throws if no project found or if multiple projects found in different orgs.
- *
- * @param projectSlug - Project slug to search for
- * @param logId - Log ID (used in error messages)
- * @returns Resolved target with org and project info
- * @throws {ContextError} If no project found
- * @throws {ValidationError} If project exists in multiple organizations
- *
- * @internal Exported for testing
- */
-export async function resolveFromProjectSearch(
-  projectSlug: string,
-  logId: string
-): Promise<ResolvedLogTarget> {
-  const found = await findProjectsBySlug(projectSlug);
-  if (found.length === 0) {
-    throw new ContextError(`Project "${projectSlug}"`, USAGE_HINT, [
-      "Check that you have access to a project with this slug",
-    ]);
-  }
-  if (found.length > 1) {
-    const orgList = found.map((p) => `  ${p.orgSlug}/${p.slug}`).join("\n");
-    throw new ValidationError(
-      `Project "${projectSlug}" exists in multiple organizations.\n\n` +
-        `Specify the organization:\n${orgList}\n\n` +
-        `Example: sentry log view <org>/${projectSlug} ${logId}`
-    );
-  }
-  // Safe assertion: length is exactly 1 after the checks above
-  const foundProject = found[0] as (typeof found)[0];
-  return {
-    org: foundProject.orgSlug,
-    project: foundProject.slug,
-  };
-}
-
 /**
  * Write human-readable log output to stdout.
  *
@@ -187,7 +150,10 @@ export const viewCommand = buildCommand({
         break;
 
       case "project-search":
-        target = await resolveFromProjectSearch(parsed.projectSlug, logId);
+        target = await resolveProjectBySlug(parsed.projectSlug, {
+          usageHint: USAGE_HINT,
+          contextValue: logId,
+        });
         break;
 
       case "org-all":

src/commands/profile/index.ts

@@ -0,0 +1,19 @@
+import { buildRouteMap } from "@stricli/core";
+import { listCommand } from "./list.js";
+import { viewCommand } from "./view.js";
+
+export const profileRoute = buildRouteMap({
+  routes: {
+    list: listCommand,
+    view: viewCommand,
+  },
+  docs: {
+    brief: "Analyze CPU profiling data",
+    fullDescription:
+      "View and analyze CPU profiling data from your Sentry projects.\n\n" +
+      "Commands:\n" +
+      "  list    List transactions with profiling data\n" +
+      "  view    View CPU profiling analysis for a transaction",
+    hideRoute: {},
+  },
+});