awesome-agents 0.1.3 → 0.1.6

package/src/cli.js

@@ -1,5 +1,7 @@
 import { Command } from "commander";
-import { PACKAGE_NAME, PACKAGE_VERSION, SUPPORTED_AGENTS } from "./constants.js";
+import checkbox from "@inquirer/checkbox";
+import { stripVTControlCharacters } from "node:util";
+import { HARNESS_COMMANDS, PACKAGE_NAME, PACKAGE_VERSION, SUPPORTED_AGENTS } from "./constants.js";
 import { configureHelp, formatMissingSourceError, ui } from "./help.js";
 import {
   initProfile,
@@ -15,7 +17,7 @@ export async function run(argv = process.argv) {
   const program = new Command();
   program
     .name(PACKAGE_NAME)
-    .description("Install reusable agent profiles into Codex, Claude Code, and OpenCode.")
+    .description("Install reusable agent profiles into Codex, Claude Code, OpenCode, and tenex-edge.")
     .version(PACKAGE_VERSION, "-v, --version")
     .helpOption("-h, --help", "Show this help message")
     .showHelpAfterError();
@@ -140,14 +142,14 @@ function addInstallCommand(program, commandName) {
     .argument("[source]", "Local path, GitHub owner/repo, or GitHub URL")
     .description(commandName === "install" ? "Alias for add" : "Install agent profiles from a source")
     .option("-g, --global", "Install globally")
-    .option("-p, --project", "Install into the current project; not supported for Codex profiles")
+    .option("-p, --project", "Install into the current project; not supported for Codex or tenex-edge profiles")
     .option("-a, --agent <agents...>", "Agent profile slugs to install; accepts harness names for backward compatibility")
     .option("--harness <harnesses...>", `Target harnesses (${SUPPORTED_AGENTS.join(", ")}, or *)`)
     .option("--target <harnesses...>", "Compatibility alias for --harness")
     .option("-s, --profile <profiles...>", "Profile slugs to install (or *)")
     .option("--skill <profiles...>", "Compatibility alias for --profile")
     .option("-l, --list", "List available profiles in the source without installing")
-    .option("-y, --yes", "Accepted for npx skills parity; prompts are not used")
+    .option("-y, --yes", "Accept detected profile and harness selections without opening selectors")
     .option("--all", "Install all profiles to all supported agents")
     .option("--dry-run", "Print planned installs without writing files")
     .option("--force", "Allow overwriting files without the generated marker")
@@ -170,7 +172,11 @@ function addInstallCommand(program, commandName) {
         return;
       }
 
-      const result = await installFromSource(source, options);
+      const result = await installFromSource(source, {
+        ...options,
+        chooseProfiles: shouldPromptForProfiles(options) ? promptProfileSelection : undefined,
+        chooseHarnesses: shouldPromptForHarnesses(options) ? promptHarnessSelection : undefined
+      });
       if (options.json) {
         printJson(result);
       } else {
@@ -186,7 +192,12 @@ function printAvailable(profiles) {
   }
   console.log(ui.bold("Available profiles:"));
   for (const profile of profiles) {
-    console.log(`  ${ui.profile(profile.slug)}  ${profile.summary || profile.name}`);
+    const summary = profile.summary || profile.name;
+    console.log(`  ${ui.profile(profile.slug)}  ${ui.dim(shortText(summary, 100))}`);
+    const details = formatProfileDetails(profile);
+    if (details) {
+      console.log(`    ${details}`);
+    }
   }
 }
 
@@ -216,6 +227,9 @@ function printOperations(operations, registryPath, runInstructions = []) {
   if (registryPath) {
     console.log(`${ui.bold("Registry:")} ${ui.path(registryPath)}`);
   }
+  if (runInstructions.length > 0) {
+    console.log("");
+  }
   printRunInstructions(runInstructions);
 }
 
@@ -225,10 +239,11 @@ function printRunInstructions(runInstructions = []) {
   }
 
   console.log(ui.bold("Run installed profiles:"));
-  for (const instruction of runInstructions) {
-    console.log(`  ${ui.profile(instruction.profile)} via ${ui.command(instruction.harness)}: ${ui.command(instruction.command)}`);
-    if (instruction.note) {
-      console.log(`    ${instruction.note}`);
+  for (const group of groupRunInstructions(runInstructions)) {
+    const summary = group.summary ? ` -- ${ui.dim(shortText(group.summary, 120))}` : "";
+    console.log(`  ${ui.profile(group.profile)}${summary}`);
+    for (const instruction of group.instructions) {
+      console.log(`      ${ui.command(runHarnessLabel(instruction.harness))}: ${ui.command(instruction.command)}`);
     }
   }
 }
@@ -243,3 +258,118 @@ function formatAction(action) {
   }
   return ui.success(action);
 }
+
+function shouldPromptForProfiles(options) {
+  return Boolean(process.stdin.isTTY && process.stdout.isTTY && !options.json && !options.yes);
+}
+
+function shouldPromptForHarnesses(options) {
+  return Boolean(process.stdin.isTTY && process.stdout.isTTY && !options.json && !options.yes);
+}
+
+async function promptProfileSelection(profiles) {
+  if (profiles.length === 0) {
+    return [];
+  }
+
+  return checkbox({
+    message: "Select agent profiles to install",
+    choices: profiles.map((profile) => {
+      const name = formatPromptChoice(profile);
+      return {
+        value: profile.slug,
+        name,
+        checkedName: name,
+        short: profile.slug,
+        description: formatPromptDescription(profile),
+        checked: true
+      };
+    }),
+    pageSize: Math.min(Math.max(profiles.length, 7), 12),
+    required: true,
+    loop: false
+  });
+}
+
+async function promptHarnessSelection(harnesses) {
+  return checkbox({
+    message: "Select target harnesses",
+    choices: harnesses.map((harness) => {
+      const name = formatHarnessChoice(harness);
+      return {
+        value: harness,
+        name,
+        checkedName: name,
+        short: harness,
+        checked: true
+      };
+    }),
+    pageSize: Math.min(Math.max(harnesses.length, 4), 8),
+    required: true,
+    loop: false
+  });
+}
+
+function formatHarnessChoice(harness) {
+  const command = HARNESS_COMMANDS.get(harness);
+  return command ? `${ui.command(harness)}  ${ui.dim(`detected: ${command}`)}` : ui.command(harness);
+}
+
+function formatPromptChoice(profile) {
+  const summary = profile.summary || profile.name;
+  return `${ui.profile(profile.slug)}  ${ui.dim(shortText(summary, 88))}`;
+}
+
+function formatPromptDescription(profile) {
+  return [
+    profile.summary || profile.name,
+    formatProfileDetails(profile)
+  ].filter(Boolean).join("\n");
+}
+
+function formatProfileDetails(profile) {
+  const details = [];
+  if (profile.kind) {
+    details.push(`kind: ${profile.kind}`);
+  }
+  if (profile.adapters?.length) {
+    details.push(`custom adapters: ${profile.adapters.join(", ")}`);
+  }
+  return details.length > 0 ? ui.dim(details.join(" | ")) : "";
+}
+
+function groupRunInstructions(runInstructions) {
+  const groups = new Map();
+  for (const instruction of runInstructions) {
+    const key = instruction.profile;
+    if (!groups.has(key)) {
+      groups.set(key, {
+        profile: instruction.profile,
+        name: instruction.name,
+        summary: instruction.summary,
+        instructions: []
+      });
+    }
+    groups.get(key).instructions.push(instruction);
+  }
+  return [...groups.values()];
+}
+
+function runHarnessLabel(harness) {
+  if (harness === "claude-code") {
+    return "claude";
+  }
+  return harness;
+}
+
+function shortText(value, maxLength) {
+  const text = stripVTControlCharacters(String(value ?? ""))
+    .replace(/\s+/g, " ")
+    .trim();
+
+  if (text.length <= maxLength) {
+    return text;
+  }
+
+  return `${text.slice(0, Math.max(0, maxLength - 3)).trimEnd()}...`;
+}

package/src/constants.js

@@ -1,7 +1,7 @@
 export const PACKAGE_NAME = "awesome-agents";
-export const PACKAGE_VERSION = "0.1.3";
+export const PACKAGE_VERSION = "0.1.6";
 export const DEFAULT_AGENT = "codex";
-export const SUPPORTED_AGENTS = ["codex", "claude-code", "opencode"];
+export const SUPPORTED_AGENTS = ["codex", "claude-code", "opencode", "tenex-edge"];
 export const REGISTRY_DIRNAME = ".awesome-agents";
 export const REGISTRY_FILENAME = "installed.json";
 export const GENERATED_MARKER = "Generated by awesome-agents";
@@ -14,5 +14,16 @@ export const AGENT_ALIASES = new Map([
   ["claude-code", "claude-code"],
   ["claudecode", "claude-code"],
   ["opencode", "opencode"],
-  ["open-code", "opencode"]
+  ["open-code", "opencode"],
+  ["tenex", "tenex-edge"],
+  ["tenex-edge", "tenex-edge"],
+  ["tenexedge", "tenex-edge"]
+]);
+
+// The CLI binary used to detect whether a harness is available on PATH.
+export const HARNESS_COMMANDS = new Map([
+  ["codex", "codex"],
+  ["claude-code", "claude"],
+  ["opencode", "opencode"],
+  ["tenex-edge", "tenex-edge"]
 ]);

package/src/help.js

@@ -173,7 +173,7 @@ export function formatMissingSourceError(commandName = "add") {
   ].join("\n");
 }
 
-const sourceHint = `${ui.profile("agents/profiles/*.{agent.yaml,agf.yaml,md}")} plus optional ${ui.profile("agents/adapters/<harness>/*")}`;
+const sourceHint = `${ui.profile("agents/<slug>/agent.yaml")} plus optional ${ui.profile("agents/<slug>/{scripts,references}")}`;
 const harnesses = SUPPORTED_AGENTS.join("|");
 const exampleSource = "owner/repo";
 const exampleProfile = "triage-agent";
@@ -188,13 +188,13 @@ const banner = [
   color("                       | (_| | (_| |  __/ | | | |_\\__ \\  ", codes.bannerB),
   color("                        \\__,_|\\__, |\\___|_| |_|\\__|___/  ", codes.bannerA),
   color("                              |___/                       ", codes.bannerA),
-  `  ${ui.dim("Operational profiles for Codex, Claude Code, and OpenCode")}`
+  `  ${ui.dim("Operational profiles for Codex, Claude Code, OpenCode, and tenex-edge")}`
 ];
 
 const mainHelp = {
   banner,
   usage: `${PACKAGE_NAME} <command> [options]`,
-  description: "Install reusable operational agent profiles into Codex, Claude Code, and OpenCode.",
+  description: "Install reusable operational agent profiles into Codex, Claude Code, OpenCode, and tenex-edge.",
   sections: [
     {
       title: "Manage Profiles:",
@@ -270,7 +270,7 @@ const mainHelp = {
   examples: [
     { command: `${PACKAGE_NAME} add ${exampleSource} --list`, comment: "inspect source profiles" },
     { command: `${PACKAGE_NAME} add ${exampleSource} --agent ${exampleProfile}` },
-    { command: `${PACKAGE_NAME} add ${exampleSource} --agent ${exampleProfile} --harness opencode` },
+    { command: `${PACKAGE_NAME} add ${exampleSource} --agent ${exampleProfile} --harness tenex-edge` },
     { command: `${PACKAGE_NAME} add ${exampleSource} --all --dry-run`, comment: "preview every write" },
     { command: `${PACKAGE_NAME} use ${exampleSource}@${exampleProfile} --harness claude-code` },
     { command: `${PACKAGE_NAME} list --json`, comment: "machine-readable output" },
@@ -288,9 +288,9 @@ const commandHelp = {
       {
         title: "Install Flow:",
         rows: [
-          "1. Read canonical profiles from agents/profiles/*.{agent.yaml,agf.yaml,md}.",
-          "2. Merge optional harness notes from agents/adapters/<harness>/*.",
-          "3. Render Codex, Claude Code, or OpenCode files and record them in the registry."
+          "1. Read canonical definitions from agents/<slug>/agent.yaml or compatible variants.",
+          "2. Install agent-owned scripts, references, and declared skills into ~/.agents/homes/<slug>/.",
+          "3. Render Codex, Claude Code, OpenCode, or tenex-edge files and record them in the registry."
         ]
       },
       {
@@ -308,6 +308,7 @@ const commandHelp = {
           { term: ui.option("--agent triage-agent"), description: "Preferred shorthand: install one profile slug" },
           { term: ui.option("--profile triage-agent"), description: "Explicit profile selector" },
           { term: ui.option("--skill triage-agent"), description: "Compatibility alias for --profile" },
+          { term: ui.option("(interactive)"), description: "Without a profile selector, choose source profiles from a checkbox list" },
           { term: ui.option("--all"), description: "Install every source profile" },
           { term: ui.option("--list"), description: "Show available profiles and exit" }
         ]
@@ -315,9 +316,9 @@ const commandHelp = {
       {
         title: "Choose Targets:",
         rows: [
-          { term: ui.option("(default)"), description: "Codex, installed globally as a config profile" },
+          { term: ui.option("(auto-detect)"), description: "Every harness detected on PATH; interactive multi-detect opens a checked selector; pass --harness when none are detected" },
           { term: ui.option("--harness opencode"), description: "Render for one harness" },
-          { term: ui.option("--harness codex claude-code"), description: "Render for multiple harnesses" },
+          { term: ui.option("--harness codex tenex-edge"), description: "Render for multiple harnesses" },
           { term: ui.option("--harness *"), description: "Render for every supported harness" },
           { term: ui.option("--global"), description: "Install into the user-level harness directory" },
           { term: ui.option("--project"), description: "Install project-local files where the harness supports it" }
@@ -329,6 +330,7 @@ const commandHelp = {
           { term: ui.command("codex"), description: `${ui.path("~/.codex/<profile>.config.toml")} (project-local Codex profiles are not supported)` },
           { term: ui.command("claude-code"), description: `${ui.path("~/.claude/agents/<profile>.md")} or ${ui.path(".claude/agents/<profile>.md")}` },
           { term: ui.command("opencode"), description: `${ui.path("~/.config/opencode/agents/<profile>.md")} or ${ui.path(".opencode/agents/<profile>.md")}` },
+          { term: ui.command("tenex-edge"), description: `${ui.path("~/.tenex-edge/agents/<profile>.json")} (project-local tenex-edge agents are not supported)` },
           { term: ui.command("registry"), description: `${ui.path("~/.awesome-agents/installed.json")} or ${ui.path(".awesome-agents/installed.json")}` }
         ]
       },
@@ -346,7 +348,7 @@ const commandHelp = {
     examples: [
       { command: `${PACKAGE_NAME} add ${exampleSource} --list` },
       { command: `${PACKAGE_NAME} add ${exampleSource} --agent ${exampleProfile}` },
-      { command: `${PACKAGE_NAME} add ${exampleSource} --agent ${exampleProfile} --harness codex opencode` },
+      { command: `${PACKAGE_NAME} add ${exampleSource} --agent ${exampleProfile} --harness codex tenex-edge` },
       { command: `${PACKAGE_NAME} add ${exampleSource} --all --dry-run` }
     ],
     footer: `Generated files are marked with ${ui.profile("Generated by awesome-agents")}.`
@@ -449,14 +451,14 @@ const commandHelp = {
 function installOptions({ includeHome = false } = {}) {
   return compact([
     { term: ui.option("-g, --global"), description: "Install globally instead of into the current project" },
-    { term: ui.option("-p, --project"), description: "Install into the current project; not supported for Codex profiles" },
+    { term: ui.option("-p, --project"), description: "Install into the current project; not supported for Codex or tenex-edge profiles" },
     { term: ui.option("-a, --agent <profiles...>"), description: "Select agent profile slugs; harness names still work for compatibility" },
     { term: ui.option("--harness <harnesses...>"), description: `Select target harnesses: ${harnesses}, or *` },
     { term: ui.option("-s, --profile <profiles...>"), description: "Explicit profile selector; accepts *" },
     { term: ui.option("--skill <profiles...>"), description: "Compatibility alias for --profile" },
     { term: ui.option("-l, --list"), description: "List available source profiles without installing" },
     { term: ui.option("--all"), description: "Install all profiles to all supported harnesses" },
-    { term: ui.option("-y, --yes"), description: "Accepted for npx skills parity; prompts are not used" },
+    { term: ui.option("-y, --yes"), description: "Accept detected profile and harness selections without opening selectors" },
     { term: ui.option("--dry-run"), description: "Print planned installs without writing files" },
     { term: ui.option("--force"), description: "Allow overwriting files without the generated marker" },
     { term: ui.option("--json"), description: "Output JSON without ANSI color" },

package/src/installer.js

@@ -1,10 +1,12 @@
 import { existsSync } from "node:fs";
 import fs from "node:fs/promises";
+import os from "node:os";
 import path from "node:path";
-import { AGENT_ALIASES, DEFAULT_AGENT, SUPPORTED_AGENTS } from "./constants.js";
+import { AGENT_ALIASES, HARNESS_COMMANDS, SUPPORTED_AGENTS } from "./constants.js";
 import { contentHash, isGeneratedContent, normalizeAgentList, renderForAgent, resolveTargetPath } from "./renderers.js";
-import { loadCatalog, materializeSource, splitSourceSpec } from "./source.js";
+import { expandHome, loadCatalog, materializeSource, splitSourceSpec } from "./source.js";
 import { readRegistry, registryPath, removeInstall, upsertInstall, writeRegistry } from "./registry.js";
+import { installProfileSkills } from "./skills.js";
 
 export async function listAvailable(sourceInput, options = {}) {
   const { source } = splitSourceSpec(sourceInput);
@@ -21,25 +23,32 @@ export async function installFromSource(sourceSpec, options = {}) {
   const split = splitSourceSpec(sourceSpec);
   const source = split.source;
   const { selectors, harnessInput } = resolveInstallSelection(split, options);
-  const harnesses = normalizeAgentList(harnessInput, {
-    all: options.all,
-    defaultAgent: DEFAULT_AGENT
-  });
+  const harnesses = await resolveHarnessesForInstall(harnessInput, options);
   const scope = resolveScope(options, harnesses);
 
   const materialized = await materializeSource(source, options);
   try {
     const catalog = await loadCatalog(materialized.path);
-    const profiles = selectProfiles(catalog.profiles, selectors, options.all);
+    const profiles = await resolveProfilesForInstall(catalog.profiles, selectors, options.all, options.chooseProfiles, materialized.source);
     const registryOptions = { ...options, scope };
     const registry = await readRegistry(registryOptions);
     const operations = [];
     const installedAt = new Date().toISOString();
 
     for (const profile of profiles) {
+      const supportTargets = await installProfileSupport(profile, options);
+      const installedSkills = await installProfileSkills(profile, materialized.path, options);
+      const renderProfile = {
+        ...profile,
+        installedSkills
+      };
       for (const harness of harnesses) {
-        const content = renderForAgent(profile, harness, { source: materialized.source });
-        const target = resolveTargetPath(profile, harness, { ...options, scope });
+        const target = resolveTargetPath(renderProfile, harness, { ...options, scope });
+        const existingContent = await readExistingContent(target);
+        const content = renderForAgent(renderProfile, harness, {
+          source: materialized.source,
+          existingContent
+        });
         await writeManagedFile(target, content, options);
 
         const install = {
@@ -53,6 +62,9 @@ export async function installFromSource(sourceSpec, options = {}) {
           target,
           installedAt,
           contentSha256: contentHash(content),
+          supportTargets,
+          skillTargets: installedSkills.map((skill) => skill.path),
+          installedSkills,
           dryRun: Boolean(options.dryRun)
         };
 
@@ -88,9 +100,7 @@ export async function useFromSource(sourceSpec, options = {}) {
     throw new Error("Specify a profile with source@profile or --profile <profile>.");
   }
 
-  const harness = normalizeAgentList(harnessInput, {
-    defaultAgent: DEFAULT_AGENT
-  })[0];
+  const harness = resolveHarnessForUse(harnessInput, options);
   const materialized = await materializeSource(split.source, options);
   try {
     const catalog = await loadCatalog(materialized.path);
@@ -215,7 +225,7 @@ export async function updateInstalled(profileArgs = [], options = {}) {
 export async function initProfile(name, options = {}) {
   const slug = slugify(name || "new-agent-profile");
   const root = options.cwd ?? process.cwd();
-  const profilePath = path.join(root, "agents", "profiles", `${slug}.agent.yaml`);
+  const profilePath = path.join(root, "agents", slug, "agent.yaml");
 
   if (!options.force) {
     if (existsSync(profilePath)) {
@@ -237,6 +247,45 @@ export async function initProfile(name, options = {}) {
   };
 }
 
+async function installProfileSupport(profile, options = {}) {
+  if (!profile.supportDirs?.length) {
+    return [];
+  }
+
+  const home = path.resolve(expandHome(options.home ?? os.homedir()));
+  const agentHome = path.join(home, ".agents", "homes", profile.slug);
+  const targets = [];
+
+  for (const supportDir of profile.supportDirs) {
+    const files = await listFilesRecursive(supportDir.sourcePath);
+    for (const source of files) {
+      const relative = path.relative(supportDir.sourcePath, source);
+      const target = path.join(agentHome, supportDir.kind, relative);
+      targets.push(target);
+      if (!options.dryRun) {
+        await fs.mkdir(path.dirname(target), { recursive: true });
+        await fs.copyFile(source, target);
+      }
+    }
+  }
+
+  return targets;
+}
+
+async function listFilesRecursive(root) {
+  const entries = await fs.readdir(root, { withFileTypes: true });
+  const files = [];
+  for (const entry of entries) {
+    const entryPath = path.join(root, entry.name);
+    if (entry.isDirectory()) {
+      files.push(...await listFilesRecursive(entryPath));
+    } else if (entry.isFile()) {
+      files.push(entryPath);
+    }
+  }
+  return files.sort();
+}
+
 function buildRunInstructions(operations, env = process.env) {
   const instructions = [];
   const seen = new Set();
@@ -269,6 +318,8 @@ function runInstructionForOperation(operation, env) {
     }
     return {
       profile: operation.profile,
+      name: operation.name,
+      summary: operation.summary,
       harness: operation.harness,
       command: `codex --profile ${shellWord(operation.profile)}`,
       note: "Starts Codex with this installed profile."
@@ -281,6 +332,8 @@ function runInstructionForOperation(operation, env) {
     }
     return {
       profile: operation.profile,
+      name: operation.name,
+      summary: operation.summary,
       harness: operation.harness,
       command: `claude --agent ${shellWord(operation.profile)}`,
       note: "Starts Claude Code with this installed agent profile."
@@ -293,15 +346,77 @@ function runInstructionForOperation(operation, env) {
     }
     return {
       profile: operation.profile,
+      name: operation.name,
+      summary: operation.summary,
       harness: operation.harness,
       command: "opencode",
       note: `Start OpenCode, then invoke @${operation.profile} in the session.`
     };
   }
 
+  if (operation.harness === "tenex-edge") {
+    if (!commandExists("tenex-edge", env)) {
+      return undefined;
+    }
+    return {
+      profile: operation.profile,
+      name: operation.name,
+      summary: operation.summary,
+      harness: operation.harness,
+      command: `tenex-edge launch ${shellWord(operation.profile)}`,
+      note: "Starts this profile as a tenex-edge-managed Claude Code agent."
+    };
+  }
+
   return undefined;
 }
 
+async function resolveHarnessesForInstall(harnessInput, options = {}) {
+  if (options.all || harnessInput !== undefined) {
+    return normalizeAgentList(harnessInput, { all: options.all });
+  }
+
+  const detected = detectAvailableHarnesses(options.env ?? process.env);
+  if (detected.length === 0) {
+    throw new Error(noDetectedHarnessMessage());
+  }
+
+  if (detected.length > 1 && typeof options.chooseHarnesses === "function") {
+    const chosen = await options.chooseHarnesses(detected);
+    const harnesses = normalizeAgentList(chosen);
+    if (harnesses.length === 0) {
+      throw new Error("Select at least one harness to install, or pass --harness <harness>.");
+    }
+    return harnesses;
+  }
+
+  return detected;
+}
+
+function resolveHarnessForUse(harnessInput, options = {}) {
+  const explicit = normalizeAgentList(harnessInput);
+  if (explicit.length > 0) {
+    return explicit[0];
+  }
+
+  const detected = detectAvailableHarnesses(options.env ?? process.env);
+  if (detected.length === 0) {
+    throw new Error(noDetectedHarnessMessage());
+  }
+  if (detected.length > 1) {
+    throw new Error(`Multiple harnesses detected (${detected.join(", ")}). Pass --harness <harness> because use renders one target at a time.`);
+  }
+  return detected[0];
+}
+
+function detectAvailableHarnesses(env = process.env) {
+  return SUPPORTED_AGENTS.filter((harness) => commandExists(HARNESS_COMMANDS.get(harness), env));
+}
+
+function noDetectedHarnessMessage() {
+  return `No supported harness CLI detected on PATH. Pass --harness <${SUPPORTED_AGENTS.join("|")}> to choose a target.`;
+}
+
 function commandExists(command, env) {
   const pathValue = env.PATH ?? "";
   if (!pathValue) {
@@ -326,6 +441,15 @@ function shellWord(value) {
   return `'${text.replaceAll("'", "'\\''")}'`;
 }
 
+async function resolveProfilesForInstall(profiles, selectors, all, chooseProfiles, source) {
+  if (!all && selectors.length === 0 && typeof chooseProfiles === "function") {
+    const chosen = await chooseProfiles(profiles.map((profile) => profileSummary(profile, source)));
+    return selectProfiles(profiles, normalizeProfileSelectors(chosen), false);
+  }
+
+  return selectProfiles(profiles, selectors, all);
+}
+
 function selectProfiles(profiles, selectors, all = false) {
   if (all || selectors.length === 0 || selectors.includes("*")) {
     return profiles;
@@ -360,6 +484,13 @@ async function writeManagedFile(target, content, options = {}) {
   await fs.writeFile(target, content);
 }
 
+async function readExistingContent(target) {
+  if (!existsSync(target)) {
+    return undefined;
+  }
+  return fs.readFile(target, "utf8");
+}
+
 function resolveScope(options = {}, harnesses = []) {
   if (options.project && options.global) {
     throw new Error("Use either --global or --project, not both.");
@@ -367,13 +498,16 @@ function resolveScope(options = {}, harnesses = []) {
   if (options.project && harnesses.includes("codex")) {
     throw new Error("Codex profiles are loaded from $CODEX_HOME/<name>.config.toml and cannot be installed project-locally. Use --global or choose a different harness.");
   }
+  if (options.project && harnesses.includes("tenex-edge")) {
+    throw new Error("tenex-edge agents are machine-local under $TENEX_EDGE_HOME/agents or ~/.tenex-edge/agents and cannot be installed project-locally. Use --global or choose a different harness.");
+  }
   if (options.global) {
     return "global";
   }
   if (options.project) {
     return "project";
   }
-  if (harnesses.includes("codex")) {
+  if (harnesses.includes("codex") || harnesses.includes("tenex-edge")) {
     return "global";
   }
   return "project";