awesome-agents 0.1.5 → 0.1.8

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "awesome-agents",
-  "version": "0.1.5",
-  "description": "Install reusable agent profiles into Codex, Claude Code, and OpenCode.",
+  "version": "0.1.8",
+  "description": "Install reusable agent profiles into Codex, Claude Code, OpenCode, Goose, and tenex-edge.",
   "type": "module",
   "bin": {
     "awesome-agents": "bin/awesome-agents.js"
@@ -28,6 +28,7 @@
     "codex",
     "claude-code",
     "opencode",
+    "goose",
     "cli"
   ],
   "author": "Pablo Fernandez",
@@ -43,6 +44,7 @@
     "node": ">=22.12.0"
   },
   "dependencies": {
+    "@inquirer/checkbox": "^4.3.2",
     "commander": "^15.0.0",
     "yaml": "^2.9.0"
   }

package/scripts/release.js

@@ -28,10 +28,6 @@ async function main() {
   const nextVersion = resolveNextVersion(currentVersion, options.bump);
   const tag = `v${nextVersion}`;
 
-  if (!options.dryRun) {
-    assertCleanWorktree();
-  }
-
   console.log(`Release plan: ${currentVersion} -> ${nextVersion}`);
 
   if (options.dryRun) {

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, Goose, 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.5";
+export const PACKAGE_VERSION = "0.1.8";
 export const DEFAULT_AGENT = "codex";
-export const SUPPORTED_AGENTS = ["codex", "claude-code", "opencode"];
+export const SUPPORTED_AGENTS = ["codex", "claude-code", "opencode", "goose", "tenex-edge"];
 export const REGISTRY_DIRNAME = ".awesome-agents";
 export const REGISTRY_FILENAME = "installed.json";
 export const GENERATED_MARKER = "Generated by awesome-agents";
@@ -14,12 +14,18 @@ export const AGENT_ALIASES = new Map([
   ["claude-code", "claude-code"],
   ["claudecode", "claude-code"],
   ["opencode", "opencode"],
-  ["open-code", "opencode"]
+  ["open-code", "opencode"],
+  ["goose", "goose"],
+  ["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"]
+  ["opencode", "opencode"],
+  ["goose", "goose"],
+  ["tenex-edge", "tenex-edge"]
 ]);

package/src/help.js

@@ -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, Goose, 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, Goose, 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" },
@@ -289,8 +289,8 @@ const commandHelp = {
         title: "Install Flow:",
         rows: [
           "1. Read canonical definitions from agents/<slug>/agent.yaml or compatible variants.",
-          "2. Install agent-owned scripts and references into ~/.agents/homes/<slug>/.",
-          "3. Render Codex, Claude Code, or OpenCode files and record them in the registry."
+          "2. Install agent-owned scripts, references, and declared skills into ~/.agents/homes/<slug>/.",
+          "3. Render Codex, Claude Code, OpenCode, Goose, 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: "Every harness detected on PATH (codex, claude, opencode); falls back to Codex if none are found" },
+          { 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,8 @@ 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("goose"), description: `${ui.path("~/.agents/agents/<profile>.md")} or ${ui.path(".agents/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 +349,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 +452,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

@@ -6,6 +6,7 @@ import { AGENT_ALIASES, HARNESS_COMMANDS, SUPPORTED_AGENTS } from "./constants.j
 import { contentHash, isGeneratedContent, normalizeAgentList, renderForAgent, resolveTargetPath } from "./renderers.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);
@@ -22,16 +23,13 @@ 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: detectAvailableHarnesses()
-  });
+  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 = [];
@@ -39,9 +37,19 @@ export async function installFromSource(sourceSpec, options = {}) {
 
     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,
+          selectedHarnesses: harnesses
+        });
         await writeManagedFile(target, content, options);
 
         const install = {
@@ -56,6 +64,8 @@ export async function installFromSource(sourceSpec, options = {}) {
           installedAt,
           contentSha256: contentHash(content),
           supportTargets,
+          skillTargets: installedSkills.map((skill) => skill.path),
+          installedSkills,
           dryRun: Boolean(options.dryRun)
         };
 
@@ -91,9 +101,7 @@ export async function useFromSource(sourceSpec, options = {}) {
     throw new Error("Specify a profile with source@profile or --profile <profile>.");
   }
 
-  const harness = normalizeAgentList(harnessInput, {
-    defaultAgent: detectAvailableHarnesses()
-  })[0];
+  const harness = resolveHarnessForUse(harnessInput, options);
   const materialized = await materializeSource(split.source, options);
   try {
     const catalog = await loadCatalog(materialized.path);
@@ -311,6 +319,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."
@@ -323,6 +333,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."
@@ -335,19 +347,91 @@ 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 === "goose") {
+    if (!commandExists("goose", env)) {
+      return undefined;
+    }
+    return {
+      profile: operation.profile,
+      name: operation.name,
+      summary: operation.summary,
+      harness: operation.harness,
+      command: "goose session",
+      note: `Start goose, 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) {
@@ -372,6 +456,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;
@@ -406,6 +499,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.");
@@ -413,13 +513,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";