feat: implemented agent detection and suggestion display [skip ci]

Author: moddi3

src/agents/detector.ts

@@ -0,0 +1,63 @@
+import { access } from "node:fs/promises";
+import { join } from "node:path";
+import { homedir } from "node:os";
+
+export interface AgentInfo {
+  name: string;
+  id: string;
+  detectionPath: string;
+  wrappedCommand: string;
+  repoUrl: string;
+  brandColor: string;
+}
+
+export interface DetectedAgent extends AgentInfo {
+  detected: boolean;
+}
+
+const AGENTS: AgentInfo[] = [
+  {
+    name: "Claude Code",
+    id: "claude",
+    detectionPath: join(homedir(), ".claude"),
+    wrappedCommand: "npx cc-wrapped",
+    repoUrl: "https://github.com/numman-ali/cc-wrapped",
+    brandColor: "#D97757",
+  },
+  {
+    name: "Codex",
+    id: "codex",
+    detectionPath: join(homedir(), ".codex"),
+    wrappedCommand: "npx codex-wrapped",
+    repoUrl: "https://github.com/numman-ali/codex-wrapped",
+    brandColor: "#3b82f6",
+  },
+  {
+    name: "Gemini CLI",
+    id: "gemini",
+    detectionPath: join(homedir(), ".gemini"),
+    wrappedCommand: "npx gemini-wrapped",
+    repoUrl: "https://github.com/jackwotherspoon/gemini-cli-wrapped",
+    brandColor: "#CBA6F7",
+  },
+];
+
+async function pathExists(path: string): Promise<boolean> {
+  try {
+    await access(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export async function detectInstalledAgents(): Promise<DetectedAgent[]> {
+  const results = await Promise.all(
+    AGENTS.map(async (agent) => ({
+      ...agent,
+      detected: await pathExists(agent.detectionPath),
+    }))
+  );
+
+  return results.filter((agent) => agent.detected);
+}

src/agents/index.ts

@@ -0,0 +1,2 @@
+export * from "./detector";
+export * from "./suggestions";

src/agents/suggestions.ts

@@ -0,0 +1,62 @@
+import * as p from "@clack/prompts";
+import type { DetectedAgent } from "./detector";
+
+function hexToRgb(hex: string): { r: number; g: number; b: number } {
+  const clean = hex.replace(/^#/, "");
+  const fullHex =
+    clean.length === 3
+      ? clean
+          .split("")
+          .map((c) => c + c)
+          .join("")
+      : clean;
+  const num = parseInt(fullHex, 16);
+  if (isNaN(num)) return { r: 255, g: 255, b: 255 };
+  return {
+    r: (num >> 16) & 255,
+    g: (num >> 8) & 255,
+    b: num & 255,
+  };
+}
+
+function colorize(text: string, hex: string): string {
+  const { r, g, b } = hexToRgb(hex);
+  return `\x1b[38;2;${r};${g};${b}m${text}\x1b[0m`;
+}
+
+function dim(text: string): string {
+  return `\x1b[2m${text}\x1b[0m`;
+}
+
+function reset(text: string): string {
+  return `\x1b[0m${text}\x1b[0m`;
+}
+
+function hyperlink(text: string, url: string): string {
+  return `\x1b]8;;${url}\x07${text}\x1b]8;;\x07`;
+}
+
+function underline(text: string): string {
+  return `\x1b[4m${text}\x1b[0m`;
+}
+
+export function displayStyledSuggestions(agents: DetectedAgent[]): void {
+  if (agents.length === 0) return;
+
+  const maxNameLength = Math.max(...agents.map((a) => a.name.length));
+  const lines = agents.map((agent) => {
+    const coloredName = colorize(agent.name, agent.brandColor);
+    const linkedName = underline(hyperlink(coloredName, agent.repoUrl));
+    const padding = " ".repeat(maxNameLength - agent.name.length);
+
+    return reset(`  ${linkedName}${padding}  ${dim("→")}  ${dim(agent.wrappedCommand)}`);
+  });
+
+  const content = [...lines, "", "Generate wrapped stats for those too!"].join("\n");
+  p.note(content, "Other AI agents detected on your system");
+}
+
+export function displayAgentSuggestions(agents: DetectedAgent[]): void {
+  if (agents.length === 0) return;
+  displayStyledSuggestions(agents);
+}

src/index.ts

@@ -13,6 +13,7 @@ import { displayInTerminal, getTerminalName } from "./terminal/display";
 import { copyImageToClipboard } from "./clipboard";
 import { isWrappedAvailable } from "./utils/dates";
 import { formatNumber } from "./utils/format";
+import { detectInstalledAgents, displayAgentSuggestions } from "./agents";
 import type { OpenCodeStats } from "./types";
 
 const VERSION = "1.0.0";
@@ -180,6 +181,9 @@ async function main() {
     }
   }
 
+  const detectedAgents = await detectInstalledAgents();
+  displayAgentSuggestions(detectedAgents);
+
   p.outro("Share your wrapped!");
   process.exit(0);
 }