@ryan_nookpi/pi-extension-cross-agent 0.1.0

package/README.md

@@ -0,0 +1,32 @@
+# cross-agent
+
+Load commands from other AI coding agent directories (`.claude/`, `.gemini/`, `.codex/`) into pi.
+
+## What it does
+
+Scans project-local and global agent directories and registers `commands/*.md` files as `/name` commands.
+
+| Source | Pattern | Behavior |
+|--------|---------|----------|
+| `commands/*.md` | Markdown with optional frontmatter | Registered as `/name` command |
+| `skills/` | Directories with `SKILL.md` or flat `.md` files | Detected but not registered (reserved for future use) |
+| `agents/*.md` | Markdown agent definitions | Detected but not registered (reserved for future use) |
+| `.pi/agents/*.md` | Pi-native agent definitions | Detected but not registered (reserved for future use) |
+
+### Scan order
+
+For each provider (`claude`, `gemini`, `codex`):
+1. `<cwd>/.<provider>/` (project-local)
+2. `~/.<provider>/` (global)
+
+First-seen command name wins on duplicates.
+
+### Command template variables
+
+Commands support `$ARGUMENTS` / `$@` (full args) and `$1`, `$2`, … (positional) substitution.
+
+## Install
+
+```bash
+pi install npm:@ryan_nookpi/pi-extension-cross-agent
+```

package/index.ts

@@ -0,0 +1,161 @@
+/**
+ * Cross-Agent — Load commands from other AI coding agent directories
+ *
+ * Scans .claude/, .gemini/, .codex/ directories (project + global) for:
+ *   commands/*.md  → registered as /name
+ *   skills/        → detected (reserved for future use)
+ *   agents/*.md    → detected (reserved for future use)
+ */
+
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, join } from "node:path";
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+
+interface Discovered {
+	name: string;
+	description: string;
+	content: string;
+}
+
+interface SourceGroup {
+	source: string;
+	commands: Discovered[];
+	skills: string[];
+	agents: Discovered[];
+}
+
+export function parseFrontmatter(raw: string): { description: string; body: string; fields: Record<string, string> } {
+	const match = raw.match(/^---\s*\n([\s\S]*?)\n---\s*\n([\s\S]*)$/);
+	if (!match) return { description: "", body: raw, fields: {} };
+
+	const front = match[1];
+	const body = match[2];
+	const fields: Record<string, string> = {};
+	for (const line of front.split("\n")) {
+		const idx = line.indexOf(":");
+		if (idx > 0) fields[line.slice(0, idx).trim()] = line.slice(idx + 1).trim();
+	}
+	return { description: fields.description || "", body, fields };
+}
+
+export function expandArgs(template: string, args: string): string {
+	const parts = args.split(/\s+/).filter(Boolean);
+	let result = template;
+	result = result.replace(/\$ARGUMENTS|\$@/g, args);
+	for (let i = 0; i < parts.length; i++) {
+		result = result.replaceAll(`$${i + 1}`, parts[i]);
+	}
+	return result;
+}
+
+function scanCommands(dir: string): Discovered[] {
+	if (!existsSync(dir)) return [];
+	const items: Discovered[] = [];
+	try {
+		for (const file of readdirSync(dir)) {
+			if (!file.endsWith(".md")) continue;
+			const raw = readFileSync(join(dir, file), "utf-8");
+			const { description, body } = parseFrontmatter(raw);
+			items.push({
+				name: basename(file, ".md"),
+				description:
+					description ||
+					body
+						.split("\n")
+						.find((l) => l.trim())
+						?.trim() ||
+					"",
+				content: body,
+			});
+		}
+	} catch {}
+	return items;
+}
+
+function scanSkills(dir: string): string[] {
+	if (!existsSync(dir)) return [];
+	const names: string[] = [];
+	try {
+		for (const entry of readdirSync(dir)) {
+			const skillFile = join(dir, entry, "SKILL.md");
+			const flatFile = join(dir, entry);
+			if (existsSync(skillFile) && statSync(skillFile).isFile()) {
+				names.push(entry);
+			} else if (entry.endsWith(".md") && statSync(flatFile).isFile()) {
+				names.push(basename(entry, ".md"));
+			}
+		}
+	} catch {}
+	return names;
+}
+
+function scanAgents(dir: string): Discovered[] {
+	if (!existsSync(dir)) return [];
+	const items: Discovered[] = [];
+	try {
+		for (const file of readdirSync(dir)) {
+			if (!file.endsWith(".md")) continue;
+			const raw = readFileSync(join(dir, file), "utf-8");
+			const { fields } = parseFrontmatter(raw);
+			items.push({
+				name: fields.name || basename(file, ".md"),
+				description: fields.description || "",
+				content: raw,
+			});
+		}
+	} catch {}
+	return items;
+}
+
+export default function (pi: ExtensionAPI) {
+	pi.on("session_start", async (_event, ctx) => {
+		const home = homedir();
+		const cwd = ctx.cwd;
+		const providers = ["claude", "gemini", "codex"];
+		const groups: SourceGroup[] = [];
+
+		for (const p of providers) {
+			for (const [dir, label] of [
+				[join(cwd, `.${p}`), `.${p}`],
+				[join(home, `.${p}`), `~/.${p}`],
+			] as const) {
+				const commands = scanCommands(join(dir, "commands"));
+				const skills = scanSkills(join(dir, "skills"));
+				const agents = scanAgents(join(dir, "agents"));
+
+				if (commands.length || skills.length || agents.length) {
+					groups.push({ source: label, commands, skills, agents });
+				}
+			}
+		}
+
+		// Also scan .pi/agents/
+		const localAgents = scanAgents(join(cwd, ".pi", "agents"));
+		if (localAgents.length) {
+			groups.push({ source: ".pi/agents", commands: [], skills: [], agents: localAgents });
+		}
+
+		// Register commands
+		const seenCmds = new Set<string>();
+
+		for (const g of groups) {
+			for (const cmd of g.commands) {
+				if (seenCmds.has(cmd.name)) continue;
+				seenCmds.add(cmd.name);
+				pi.registerCommand(cmd.name, {
+					description: `[${g.source}] ${cmd.description}`.slice(0, 120),
+					handler: async (args) => {
+						pi.sendUserMessage(expandArgs(cmd.content, args || ""));
+					},
+				});
+			}
+		}
+
+		if (groups.length === 0) return;
+
+		setTimeout(() => {
+			if (!ctx.hasUI) return;
+		}, 100);
+	});
+}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@ryan_nookpi/pi-extension-cross-agent",
+  "version": "0.1.0",
+  "description": "Load commands from Claude, Gemini, and Codex agent directories into pi.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Jonghakseo/pi-extension.git",
+    "directory": "packages/cross-agent"
+  },
+  "bugs": {
+    "url": "https://github.com/Jonghakseo/pi-extension/issues"
+  },
+  "homepage": "https://github.com/Jonghakseo/pi-extension/tree/main/packages/cross-agent#readme",
+  "type": "module",
+  "keywords": [
+    "pi-package"
+  ],
+  "files": [
+    "index.ts",
+    "README.md"
+  ],
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ]
+  },
+  "peerDependencies": {
+    "@mariozechner/pi-coding-agent": "*"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}