@youtyan/code-viewer 0.1.38 → 0.1.39

package/README.md

@@ -151,17 +151,18 @@ to target a specific one.
 
 ### Agent Skill
 
-The package bundles an [Agent Skill](https://code.claude.com/docs/en/skills)
-that teaches AI coding agents when and how to use `annotate`. Install it
-into the current project (`.claude/skills/`):
+The package bundles an [Agent Skill](https://agentskills.io) (the SKILL.md
+open standard) that teaches AI coding agents when and how to use
+`annotate`. Install it into the current project:
 
 ```sh
-npx -y @youtyan/code-viewer skill install
+npx -y @youtyan/code-viewer skill install                       # Claude Code (.claude/skills/)
+npx -y @youtyan/code-viewer skill install --agent codex,gemini  # other agents
+npx -y @youtyan/code-viewer skill install --agent all           # claude, codex, gemini, cursor, .agents
 ```
 
-Or install it once for all projects with `--global`
-(`~/.claude/skills/`). Running the same command again updates an existing
-installation.
+Or install it once for all projects with `--global` (`~/.claude/skills/`
+etc). Running the same command again updates an existing installation.
 
 ## Development
 

package/dist/code-viewer.js

@@ -1652,11 +1652,28 @@ __export(exports_skill_cli, {
   runSkillCli: () => runSkillCli,
   parseSkillArgs: () => parseSkillArgs,
   installSkill: () => installSkill,
-  SKILL_HELP: () => SKILL_HELP
+  SKILL_HELP: () => SKILL_HELP,
+  AGENT_SKILL_DIRS: () => AGENT_SKILL_DIRS
 });
 import { cpSync, existsSync as existsSync5, mkdirSync as mkdirSync3 } from "node:fs";
 import { homedir as homedir2 } from "node:os";
 import { join as join5, resolve } from "node:path";
+function parseAgentList(value) {
+  if (value === "all")
+    return [...AGENT_NAMES];
+  const names = value.split(",").map((name) => name.trim()).filter(Boolean);
+  if (names.length === 0)
+    return null;
+  const result = [];
+  for (const name of names) {
+    if (!(name in AGENT_SKILL_DIRS))
+      return null;
+    const agent = name;
+    if (!result.includes(agent))
+      result.push(agent);
+  }
+  return result;
+}
 function parseSkillArgs(argv) {
   if (argv.length === 0 || argv.includes("--help") || argv[0] === "help") {
     return { ok: true, args: { kind: "help" } };
@@ -1667,6 +1684,7 @@ function parseSkillArgs(argv) {
   }
   let global = false;
   let cwd;
+  let agents = ["claude"];
   for (let i = 0;i < rest.length; i++) {
     const arg = rest[i];
     if (arg === "--global") {
@@ -1675,11 +1693,23 @@ function parseSkillArgs(argv) {
       cwd = rest[++i];
       if (!cwd)
         return { ok: false, error: "--cwd requires a directory" };
+    } else if (arg === "--agent") {
+      const value = rest[++i];
+      if (!value)
+        return { ok: false, error: "--agent requires a list" };
+      const parsed = parseAgentList(value);
+      if (!parsed) {
+        return {
+          ok: false,
+          error: `unknown agent in "${value}" (valid: ${AGENT_NAMES.join(", ")}, all)`
+        };
+      }
+      agents = parsed;
     } else {
       return { ok: false, error: `unknown option: ${arg}` };
     }
   }
-  return { ok: true, args: { kind: "install", global, cwd } };
+  return { ok: true, args: { kind: "install", agents, global, cwd } };
 }
 function installSkill(args, deps) {
   if (!existsSync5(join5(deps.sourceDir, "SKILL.md"))) {
@@ -1689,15 +1719,19 @@ function installSkill(args, deps) {
     };
   }
   const base = args.global ? deps.homeDir : resolve(args.cwd ?? deps.projectDir);
-  const target = join5(base, ".claude", "skills", SKILL_NAME);
-  const action = existsSync5(target) ? "updated" : "installed";
-  try {
-    mkdirSync3(target, { recursive: true });
-    cpSync(deps.sourceDir, target, { recursive: true });
-  } catch (error) {
-    return { ok: false, error: String(error) };
+  const results = [];
+  for (const agent of args.agents) {
+    const target = join5(base, AGENT_SKILL_DIRS[agent], "skills", SKILL_NAME);
+    const action = existsSync5(target) ? "updated" : "installed";
+    try {
+      mkdirSync3(target, { recursive: true });
+      cpSync(deps.sourceDir, target, { recursive: true });
+    } catch (error) {
+      return { ok: false, error: String(error) };
+    }
+    results.push({ agent, action, target });
   }
-  return { ok: true, action, target };
+  return { ok: true, results };
 }
 function runSkillCli(argv) {
   const parsed = parseSkillArgs(argv);
@@ -1719,27 +1753,44 @@ function runSkillCli(argv) {
     console.error(result.error);
     process.exit(1);
   }
-  console.log(`${result.action}: ${result.target}`);
-  if (result.action === "installed") {
+  for (const entry of result.results) {
+    console.log(`${entry.action} (${entry.agent}): ${entry.target}`);
+  }
+  if (result.results.some((entry) => entry.action === "installed")) {
     console.log("Re-run the same command anytime to update the skill.");
   }
 }
-var SKILL_NAME = "code-viewer-annotate", SKILL_HELP;
+var SKILL_NAME = "code-viewer-annotate", AGENT_SKILL_DIRS, AGENT_NAMES, SKILL_HELP;
 var init_skill_cli = __esm(() => {
   init_root();
+  AGENT_SKILL_DIRS = {
+    claude: ".claude",
+    codex: ".codex",
+    gemini: ".gemini",
+    cursor: ".cursor",
+    agents: ".agents"
+  };
+  AGENT_NAMES = Object.keys(AGENT_SKILL_DIRS);
   SKILL_HELP = `code-viewer skill — manage the bundled agent skill
 
 Usage:
-  code-viewer skill install [--global] [--cwd <dir>]
+  code-viewer skill install [--agent <list>] [--global] [--cwd <dir>]
 
-Installs the ${SKILL_NAME} skill (SKILL.md for AI coding agents) into
-.claude/skills/ of the current project, or into ~/.claude/skills/ with
---global. Running install again overwrites the files, so the same command
-also updates an existing installation.
+Installs the ${SKILL_NAME} skill (SKILL.md for AI coding agents) into the
+skills directory of each selected agent in the current project, or into the
+home directory equivalents with --global. Running install again overwrites
+the files, so the same command also updates an existing installation.
 
 Options:
-  --global      install into ~/.claude/skills/ instead of the project
-  --cwd <dir>   project directory to install into (ignored with --global)
+  --agent <list>  comma separated agents: ${AGENT_NAMES.join(", ")}, or all
+                  (default: claude)
+  --global        install into the home directory (~/.claude/skills/ etc)
+  --cwd <dir>     project directory to install into (ignored with --global)
+
+Examples:
+  code-viewer skill install
+  code-viewer skill install --agent claude,codex,gemini
+  code-viewer skill install --agent all --global
 `;
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@youtyan/code-viewer",
-  "version": "0.1.38",
+  "version": "0.1.39",
   "description": "Local browser-based code and git diff viewer",
   "type": "module",
   "bin": {

package/web/app.js

@@ -246,6 +246,8 @@
       allowPaletteOpen: true
     },
     { action: "focus-file-filter", key: "/" },
+    { action: "annotation-next", key: "]" },
+    { action: "annotation-previous", key: "[" },
     { action: "focus-sidebar", key: "h", ctrl: true },
     { action: "focus-main", key: "l", ctrl: true },
     {
@@ -7339,6 +7341,13 @@ ${frontmatter.yaml}
         sessionEl.className = "annotation-session";
         sessionEl.dataset.sessionId = session.id;
         sessionEl.classList.toggle("active", session.id === activeSessionId);
+        sessionEl.addEventListener("click", (event) => {
+          const target = event.target;
+          if (target.closest("button, a, input"))
+            return;
+          if (session.id !== activeSessionId)
+            setActiveSession(session.id);
+        });
         const head = document.createElement("div");
         head.className = "annotation-session-head";
         const title = document.createElement("button");
@@ -7572,14 +7581,18 @@ ${frontmatter.yaml}
         deps.scrollDiffElementIntoView(inlineRow, "center");
     }
     function stepAnnotation(direction) {
-      if (!activeAnnotationId)
+      const found = activeAnnotationId ? findAnnotation(activeAnnotationId) : null;
+      if (found && (!activeSessionId || found.session.id === activeSessionId)) {
+        const next = found.session.entries[found.index + direction];
+        if (next)
+          openAnnotationEntry(next.id);
         return;
-      const found = findAnnotation(activeAnnotationId);
-      if (!found)
-        return;
-      const next = found.session.entries[found.index + direction];
-      if (next)
-        openAnnotationEntry(next.id);
+      }
+      const session = ANNOTATIONS.sessions.find((s2) => s2.id === activeSessionId) ?? ANNOTATIONS.sessions[0];
+      const entries = session?.entries ?? [];
+      const entry = direction === 1 ? entries[0] : entries[entries.length - 1];
+      if (entry)
+        openAnnotationEntry(entry.id);
     }
     function handleSse(raw) {
       let event = null;
@@ -7650,7 +7663,8 @@ ${frontmatter.yaml}
       },
       getActiveAnnotationId() {
         return activeAnnotationId;
-      }
+      },
+      stepAnnotation
     };
   }
 
@@ -8794,7 +8808,8 @@ ${frontmatter.yaml}
                 ["Ctrl+K", "Open file palette"],
                 ["Ctrl+G", "Open grep palette"],
                 ["/", "Focus file filter"],
-                ["t", "Toggle theme"]
+                ["t", "Toggle theme"],
+                ["[ / ]", "Previous / next annotation"]
               ]
             },
             {
@@ -8842,7 +8857,8 @@ ${frontmatter.yaml}
                 ["Ctrl+K", "ファイルパレットを開く"],
                 ["Ctrl+G", "grep パレットを開く"],
                 ["/", "ファイルフィルターへフォーカス"],
-                ["t", "テーマ切り替え"]
+                ["t", "テーマ切り替え"],
+                ["[ / ]", "前 / 次の注釈へ移動"]
               ]
             },
             {
@@ -15631,6 +15647,10 @@ ${frontmatter.yaml}
       if (action === "tab-preview" || action === "tab-code") {
         return switchSourceTab(action === "tab-preview" ? "preview" : "code");
       }
+      if (action === "annotation-next" || action === "annotation-previous") {
+        ANNOTATIONS_UI?.stepAnnotation(action === "annotation-next" ? 1 : -1);
+        return true;
+      }
       if (action === "start-g-sequence") {
         PENDING_G_SCOPE = scope;
         PENDING_G_UNTIL = performance.now() + 900;

package/web/style.css

@@ -1132,7 +1132,8 @@ body.gdp-resizing * { user-select: none !important; }
   top: calc(var(--global-header-h) + 8px);
   width: min(460px, calc(100vw - 32px));
   max-width: calc(100vw - 32px);
-  z-index: 40;
+  /* Transient popover: must sit above the annotation panel (45). */
+  z-index: 70;
   padding: 12px;
   border: 1px solid var(--border);
   border-radius: 8px;