@thesmurph/agentlink 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.1.1
+
+- `list` shows what is linked rather than only what is installed. A `✓` means
+  agentlink is linking that harness; a trailing note appears when a harness is
+  installed but not linked, or linked but not installed. `list --json` gains
+  `selected` and a top-level `linked` array.
+- Fixed: `list` printed one mark for two different facts, so a deselected
+  harness looked selected. The selection itself was always saved correctly.
+
 ## 0.1.0
 
 First release.

package/README.md

@@ -32,7 +32,7 @@ agentlink init           create AGENTS.md + .agents/skills, migrate, link
 agentlink sync           re-link after adding or moving a skill
 agentlink fix            fold stray real copies into .agents, then link
 agentlink select         change which harnesses are linked
-agentlink list           every harness, where it reads from, whether it is installed
+agentlink list           what is linked, where each harness reads from, what is installed
 agentlink doctor         drift, duplicates, invalid skills, broken links
 agentlink adopt          move an existing CLAUDE.md or GEMINI.md into AGENTS.md
 agentlink unlink         remove the links agentlink created

package/dist/cli.js

@@ -326,9 +326,12 @@ async function syncLinks(paths, chosen, options, context) {
         process.exit(1);
 }
 async function runList(paths, options) {
+    const state = readState(paths);
+    const selected = new Set(state.harnesses);
     const rows = detectAll().map(({ harness, installed, reasons }) => ({
         id: harness.id,
         label: harness.label,
+        selected: selected.has(harness.id),
         installed,
         reasons,
         instructions: describe(harness.instructions[paths.scope]),
@@ -338,18 +341,26 @@ async function runList(paths, options) {
         source: harness.source,
     }));
     if (options.json) {
-        process.stdout.write(`${JSON.stringify({ scope: paths.scope, harnesses: rows }, null, 2)}\n`);
+        process.stdout.write(`${JSON.stringify({ scope: paths.scope, root: paths.root, linked: [...selected], harnesses: rows }, null, 2)}\n`);
         return;
     }
     const width = Math.max(...rows.map((row) => row.label.length));
-    process.stdout.write(`\n${BOLD}harnesses${RESET} ${DIM}· scope: ${paths.scope}${RESET}\n\n`);
+    const installedCount = rows.filter((row) => row.installed).length;
+    process.stdout.write(`\n${BOLD}harnesses${RESET} ${DIM}· scope: ${paths.scope} · ${selected.size} linked · ${installedCount} installed here${RESET}\n\n`);
     for (const row of rows) {
-        const mark = row.installed ? `${GREEN}●${RESET}` : `${DIM}○${RESET}`;
+        // The leading mark is the tool's own state: what is actually linked.
+        // Availability is only called out when it is surprising.
+        const mark = row.selected ? `${GREEN}✓${RESET}` : `${DIM}·${RESET}`;
+        const note = row.selected && !row.installed
+            ? `  ${YELLOW}selected, not installed${RESET}`
+            : !row.selected && row.installed
+                ? `  ${DIM}installed, not linked${RESET}`
+                : "";
         const flag = !row.instructionsVerified || !row.skillsVerified ? ` ${YELLOW}unverified${RESET}` : "";
-        process.stdout.write(`  ${mark} ${row.label.padEnd(width)}  ${DIM}instructions${RESET} ${row.instructions}  ${DIM}skills${RESET} ${row.skills}${flag}\n`);
+        process.stdout.write(`  ${mark} ${row.label.padEnd(width)}  ${DIM}instructions${RESET} ${row.instructions}  ${DIM}skills${RESET} ${row.skills}${flag}${note}\n`);
     }
-    process.stdout.write(`\n  ${GREEN}●${RESET} present on this machine   ${DIM}native = harness reads AGENTS.md / .agents/skills itself${RESET}\n` +
-        `  ${DIM}agentlink list --json prints the source URL for every row${RESET}\n`);
+    process.stdout.write(`\n  ${GREEN}✓${RESET} linked   ${DIM}·${RESET} not linked   ${DIM}change with \`agentlink select\`${RESET}\n` +
+        `  ${DIM}native = harness reads AGENTS.md / .agents/skills itself; list --json prints the source URL for every row${RESET}\n`);
 }
 function describe(endpoint) {
     if (endpoint.native)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thesmurph/agentlink",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "One source of truth for agent instructions and skills, symlinked into every coding-agent harness.",
   "keywords": [
     "agents.md",

package/src/cli.ts

@@ -388,9 +388,12 @@ async function syncLinks(
 }
 
 async function runList(paths: ScopePaths, options: Options): Promise<void> {
+  const state = readState(paths);
+  const selected = new Set(state.harnesses);
   const rows = detectAll().map(({ harness, installed, reasons }) => ({
     id: harness.id,
     label: harness.label,
+    selected: selected.has(harness.id),
     installed,
     reasons,
     instructions: describe(harness.instructions[paths.scope]),
@@ -401,25 +404,35 @@ async function runList(paths: ScopePaths, options: Options): Promise<void> {
   }));
 
   if (options.json) {
-    process.stdout.write(`${JSON.stringify({ scope: paths.scope, harnesses: rows }, null, 2)}\n`);
+    process.stdout.write(
+      `${JSON.stringify({ scope: paths.scope, root: paths.root, linked: [...selected], harnesses: rows }, null, 2)}\n`,
+    );
     return;
   }
 
   const width = Math.max(...rows.map((row) => row.label.length));
+  const installedCount = rows.filter((row) => row.installed).length;
   process.stdout.write(
-    `\n${BOLD}harnesses${RESET} ${DIM}· scope: ${paths.scope}${RESET}\n\n`,
+    `\n${BOLD}harnesses${RESET} ${DIM}· scope: ${paths.scope} · ${selected.size} linked · ${installedCount} installed here${RESET}\n\n`,
   );
   for (const row of rows) {
-    const mark = row.installed ? `${GREEN}●${RESET}` : `${DIM}○${RESET}`;
-    const flag =
-      !row.instructionsVerified || !row.skillsVerified ? ` ${YELLOW}unverified${RESET}` : "";
+    // The leading mark is the tool's own state: what is actually linked.
+    // Availability is only called out when it is surprising.
+    const mark = row.selected ? `${GREEN}✓${RESET}` : `${DIM}·${RESET}`;
+    const note =
+      row.selected && !row.installed
+        ? `  ${YELLOW}selected, not installed${RESET}`
+        : !row.selected && row.installed
+          ? `  ${DIM}installed, not linked${RESET}`
+          : "";
+    const flag = !row.instructionsVerified || !row.skillsVerified ? ` ${YELLOW}unverified${RESET}` : "";
     process.stdout.write(
-      `  ${mark} ${row.label.padEnd(width)}  ${DIM}instructions${RESET} ${row.instructions}  ${DIM}skills${RESET} ${row.skills}${flag}\n`,
+      `  ${mark} ${row.label.padEnd(width)}  ${DIM}instructions${RESET} ${row.instructions}  ${DIM}skills${RESET} ${row.skills}${flag}${note}\n`,
     );
   }
   process.stdout.write(
-    `\n  ${GREEN}●${RESET} present on this machine   ${DIM}native = harness reads AGENTS.md / .agents/skills itself${RESET}\n` +
-      `  ${DIM}agentlink list --json prints the source URL for every row${RESET}\n`,
+    `\n  ${GREEN}✓${RESET} linked   ${DIM}·${RESET} not linked   ${DIM}change with \`agentlink select\`${RESET}\n` +
+      `  ${DIM}native = harness reads AGENTS.md / .agents/skills itself; list --json prints the source URL for every row${RESET}\n`,
   );
 }