imagen-cli 0.1.2__tar.gz → 0.1.4__tar.gz

{imagen_cli-0.1.2 → imagen_cli-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: imagen-cli
-Version: 0.1.2
+Version: 0.1.4
 Summary: Persistent image creation workbench for humans and agents
 Project-URL: Homepage, https://github.com/NekoCCN/ImagenCli
 Project-URL: Source, https://github.com/NekoCCN/ImagenCli
@@ -449,6 +449,8 @@ Imagen ships skills that teach coding agents when to use it, how to discover com
 
 ```bash
 imagen skills list
+imagen skills install                     # asks which agents, in a terminal
+imagen skills install --target universal  # the shared .agents/skills directory
 imagen skills install --target claude-code --target codex
 imagen skills install --scope global --target claude-code
 imagen skills uninstall --target codex
@@ -457,10 +459,10 @@ imagen skills uninstall --target codex
 <img src="assets/imagen-cli-skills.png" alt="Agent skill installation options" width="760">
 
 - Default scope is the current project; `--scope global` installs into user directories.
-- `--target` may be repeated. `--target all` selects every target in the bundled compatibility table.
+- Without `--target`, skills go to `universal` — the shared `.agents/skills` directory that most agents read. Add more agents with `--target`, which may be repeated; `--target all` selects every target in the bundled compatibility table.
+- In a terminal without `--target`, Imagen opens a checklist: arrows move, space selects, `a` selects all, enter confirms, `q` cancels. The shared directory and any agent directory already present in the project start ticked. Without a terminal — or with `--no-interactive` — the command installs into the default target and never prompts.
 - Project-only agents are reported when global installation is requested.
 - Installation writes a managed manifest (`.imagen-install.json`). Uninstall refuses unmanaged directories and symlinked paths. A locally modified managed skill needs `--force --yes`.
-- When run in a terminal without `--target`, Imagen shows an interactive target selector.
 
 The bundled skills are `imagen`, `imagen-assets`, and `imagen-batch`.
 

{imagen_cli-0.1.2 → imagen_cli-0.1.4}/README.md

@@ -407,6 +407,8 @@ Imagen ships skills that teach coding agents when to use it, how to discover com
 
 ```bash
 imagen skills list
+imagen skills install                     # asks which agents, in a terminal
+imagen skills install --target universal  # the shared .agents/skills directory
 imagen skills install --target claude-code --target codex
 imagen skills install --scope global --target claude-code
 imagen skills uninstall --target codex
@@ -415,10 +417,10 @@ imagen skills uninstall --target codex
 <img src="assets/imagen-cli-skills.png" alt="Agent skill installation options" width="760">
 
 - Default scope is the current project; `--scope global` installs into user directories.
-- `--target` may be repeated. `--target all` selects every target in the bundled compatibility table.
+- Without `--target`, skills go to `universal` — the shared `.agents/skills` directory that most agents read. Add more agents with `--target`, which may be repeated; `--target all` selects every target in the bundled compatibility table.
+- In a terminal without `--target`, Imagen opens a checklist: arrows move, space selects, `a` selects all, enter confirms, `q` cancels. The shared directory and any agent directory already present in the project start ticked. Without a terminal — or with `--no-interactive` — the command installs into the default target and never prompts.
 - Project-only agents are reported when global installation is requested.
 - Installation writes a managed manifest (`.imagen-install.json`). Uninstall refuses unmanaged directories and symlinked paths. A locally modified managed skill needs `--force --yes`.
-- When run in a terminal without `--target`, Imagen shows an interactive target selector.
 
 The bundled skills are `imagen`, `imagen-assets`, and `imagen-batch`.
 

{imagen_cli-0.1.2 → imagen_cli-0.1.4}/README.zh-CN.md

@@ -379,6 +379,8 @@ Imagen 不会静默安装超分运行依赖或权重。源码许可不等于模
 
 ```bash
 imagen skills list
+imagen skills install                     # 在终端里询问装到哪些 agent
+imagen skills install --target universal  # 共享的 .agents/skills 目录
 imagen skills install --target claude-code --target codex
 imagen skills install --scope global --target claude-code
 imagen skills uninstall --target codex
@@ -387,10 +389,10 @@ imagen skills uninstall --target codex
 <img src="assets/imagen-cli-skills.png" alt="Agent skill 安装选项" width="760">
 
 - 默认安装到当前项目；`--scope global` 安装到用户目录。
-- `--target` 可重复；`--target all` 选择兼容表中的全部目标。
+- 未指定 `--target` 时安装到 `universal`，即多数 agent 都会读取的共享目录 `.agents/skills`。需要更多 agent 时重复传 `--target`；`--target all` 选择兼容表中的全部目标。
+- 在终端中未指定 `--target` 时打开勾选列表：方向键移动、空格选择、`a` 全选、回车确认、`q` 取消。共享目录和项目里已存在的 agent 目录默认勾选。没有终端（或加 `--no-interactive`）时直接装到默认目标，不提问。
 - 全局安装时会报告仅支持项目作用域的目标。
 - 安装会写入托管清单（`.imagen-install.json`）。卸载不会删除未托管目录或符号链接路径；已修改的受管 skill 需要 `--force --yes`。
-- 在终端中未指定 `--target` 时，会显示交互式目标选择器。
 
 随包 skills 为 `imagen`、`imagen-assets` 和 `imagen-batch`。
 

{imagen_cli-0.1.2 → imagen_cli-0.1.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "imagen-cli"
-version = "0.1.2"
+version = "0.1.4"
 description = "Persistent image creation workbench for humans and agents"
 requires-python = ">=3.12"
 license = "MIT"

{imagen_cli-0.1.2 → imagen_cli-0.1.4}/src/imagen_cli/application/skill_targets.py

@@ -11,6 +11,22 @@ def targets() -> list[dict[str, str]]:
     return list(json.loads(Path(__file__).with_suffix(".json").read_text(encoding="utf-8")))
 
 
+DEFAULT_TARGET = "universal"
+
+
+def default_root(scope: str) -> Path:
+    return root_for(DEFAULT_TARGET, scope)
+
+
+def prompt_order() -> tuple[list[str], list[str]]:
+    """Picker labels (shared directory first, then detected agents) and what starts ticked."""
+    found = set(detected()) - {DEFAULT_TARGET}
+    names = [row["name"] for row in targets() if row["name"] != DEFAULT_TARGET]
+    first = [name for name in names if name in found]
+    rest = [name for name in names if name not in found]
+    return [DEFAULT_TARGET, *first, *rest], [DEFAULT_TARGET, *first]
+
+
 def root_for(target: str, scope: str) -> Path:
     if scope not in {"project", "global"}:
         raise ValueError("scope must be project or global")
@@ -27,16 +43,19 @@ def root_for(target: str, scope: str) -> Path:
     if target == "claude-code" and os.environ.get("CLAUDE_CONFIG_DIR"):
         return Path(os.environ["CLAUDE_CONFIG_DIR"]).expanduser() / "skills"
     if value.startswith("~/.config/"):
-        config = Path(os.environ.get("XDG_CONFIG_HOME", str(Path.home() / ".config")))
+        config = Path(os.environ.get("XDG_CONFIG_HOME") or Path.home() / ".config")
         return config / value.removeprefix("~/.config/")
     return Path(value).expanduser()
 
 
 def detected() -> list[str]:
+    """Agents whose directory already exists in this project; the shared one is implicit."""
+    shared = root_for(DEFAULT_TARGET, "project")
     found = []
     for row in targets():
-        if (Path.cwd() / row["project"]).parent.is_dir():
-            found.append(row["name"])
-        elif row["global"] and root_for(row["name"], "global").parent.is_dir():
+        candidate = Path.cwd() / row["project"]
+        if candidate == shared or candidate.parent == Path.cwd():
+            continue
+        if candidate.parent.is_dir():
             found.append(row["name"])
     return found

{imagen_cli-0.1.2 → imagen_cli-0.1.4}/src/imagen_cli/application/skills_service.py

@@ -57,7 +57,7 @@ def root_for(scope: str) -> Path:
 def _roots(
     scope: str, agents: list[str] | None, *, deduplicate: bool = True
 ) -> list[tuple[str, Path]]:
-    names = agents or ["claude-code"]
+    names = agents or [skill_targets.DEFAULT_TARGET]
     if "all" in names:
         names = [row["name"] for row in skill_targets.targets() if row.get(scope)]
     roots = []
@@ -160,7 +160,7 @@ def list_(
         states = {
             current: {
                 agent: _state(root, entry["name"], bundled)
-                for agent, root in _roots(current, agents, deduplicate=False)
+                for agent, root in _roots(current, agents or ["all"], deduplicate=False)
             }
             for current in scopes
         }
@@ -271,7 +271,7 @@ def install_(
     expanded = (
         [row["name"] for row in skill_targets.targets() if row.get(scope)]
         if agents and "all" in agents
-        else agents or ["claude-code"]
+        else agents or [skill_targets.DEFAULT_TARGET]
     )
     return ("internal_error" if failed else "succeeded"), {
         "scope": scope,
@@ -314,10 +314,20 @@ def update_(
             if not (target / "SKILL.md").is_file():
                 continue
             record = _managed(target, name)
+            source = Path(bundled[name]["path"])
             if record is None:
-                conflicts.append(
-                    {"name": name, "path": str(target), "agent": agent, "reason": "not managed"}
-                )
+                # A copy Imagen did not write: identical is fine, anything else is not ours.
+                if _manifest(target, name)["files"] == _manifest(source, name)["files"]:
+                    current.append({"name": name, "path": str(target), "agent": agent})
+                else:
+                    conflicts.append(
+                        {
+                            "name": name,
+                            "path": str(target),
+                            "agent": agent,
+                            "reason": "unmanaged",
+                        }
+                    )
                 continue
             recorded = record.get("files")
             dirty = _manifest(target, name)["files"] != recorded
@@ -327,11 +337,10 @@ def update_(
                         "name": name,
                         "path": str(target),
                         "agent": agent,
-                        "reason": "modified locally",
+                        "reason": "modified",
                     }
                 )
                 continue
-            source = Path(bundled[name]["path"])
             if (
                 not dirty
                 and record.get("skill_version") == bundled[name]["version"]

{imagen_cli-0.1.2 → imagen_cli-0.1.4}/src/imagen_cli/cli/commands/history.py

@@ -4,6 +4,7 @@ import hashlib
 import json
 from typing import Any, cast
 
+from imagen_cli import i18n
 from imagen_cli.application.cleanup_service import collect, delete_session, remove_session_artifact
 from imagen_cli.application.export_service import _rows, export_session
 from imagen_cli.application.fork_service import fork
@@ -118,7 +119,12 @@ def gc_(
             "deleted": [],
         }
     if yes is not True or plan is None:
-        raise ValueError("--plan and --yes are required for destructive GC")
+        raise ValueError(
+            i18n.t(
+                "--plan and --yes are required for destructive GC",
+                "删除资产需要 --plan 与 --yes",
+            )
+        )
     if plan != digest:
         return "conflict", {
             "dry_run": False,

{imagen_cli-0.1.2 → imagen_cli-0.1.4}/src/imagen_cli/cli/entrypoint.py

@@ -328,6 +328,17 @@ def _parse(argv: list[str]) -> tuple[str, list[str] | dict[str, Any], SharedOpti
                 "imagen help",
             )
         if target_command is not None and target_command not in COMMANDS:
+            group = sorted(
+                name for name in COMMANDS if name.startswith(f"{target_command} ")
+            )
+            if group:
+                raise UsageError(
+                    i18n.t(
+                        f"'{target_command}' is a command group: {', '.join(group)}.",
+                        f"'{target_command}' 是一组命令：{', '.join(group)}。",
+                    ),
+                    f"imagen help {group[0]}",
+                )
             raise UsageError(
                 i18n.t(
                     f"Unknown help target '{target_command}'.",
@@ -622,11 +633,10 @@ def main(
                 and not any(value == "--target" or value.startswith("--target=") for value in argv)
                 and not any(value in {"--help", "-h"} for value in argv)
             ):
-                from imagen_cli.application.skill_targets import targets
+                from imagen_cli.application.skill_targets import prompt_order
 
-                selected = choose(
-                    [row["name"] for row in targets()], stdin=sys.stdin, stderr=stderr
-                )
+                labels, preselected = prompt_order()
+                selected = choose(labels, stdin=sys.stdin, stderr=stderr, selected=preselected)
                 if not selected:
                     raise KeyboardInterrupt
                 for name in selected:

{imagen_cli-0.1.2 → imagen_cli-0.1.4}/src/imagen_cli/cli/human.py

@@ -52,6 +52,154 @@ def _unknown_line(turn: dict[str, Any]) -> str:
     )
 
 
+def _conflict_reason(code: object) -> str:
+    if code == "unmanaged":
+        return t(
+            "not installed by Imagen and the content differs; delete that folder and reinstall",
+            "不是 Imagen 安装的，内容也不同；删掉该目录后重新安装",
+        )
+    if code == "modified":
+        return t("edited after install", "安装后被修改过")
+    return str(code or t("not managed by Imagen", "不是 Imagen 安装的"))
+
+
+def _detail_result_lines(data: dict[str, Any]) -> list[str]:
+    """Single-resource results: artifacts, providers, models, GC, workers, exports."""
+    lines: list[str] = []
+    artifact = data.get("artifact")
+    if isinstance(artifact, dict) and artifact.get("id"):
+        size = ""
+        if artifact.get("width") and artifact.get("height"):
+            size = f" · {artifact['width']}×{artifact['height']}"
+        lines.append(t(f"Artifact {artifact['id']}", f"产物 {artifact['id']}") + size)
+        if artifact.get("byte_size"):
+            lines.append(f"{artifact['byte_size']} bytes")
+        if data.get("path"):
+            lines.append(t("File: ", "文件：") + str(data["path"]))
+        if data.get("available") is False:
+            lines.append(t("Not available on disk", "磁盘上不可用"))
+        for row in _rows(data, "owners")[:_MAX_ROWS]:
+            lines.append(
+                f"  {row.get('role') or ''} · {row.get('session_id') or ''}"
+                f" · {row.get('source') or ''}"
+            )
+    model = data.get("model")
+    if isinstance(model, dict) and model.get("id"):
+        evidence = model.get("evidence") or "manual"
+        lines.append(t(f"Model {model['id']} ({evidence})", f"模型 {model['id']}（{evidence}）"))
+    for row in _rows(data, "items")[:_MAX_ROWS]:
+        lines.append(f"{row.get('profile')} · {row.get('provider')}/{row.get('family')}")
+    if isinstance(data.get("plan"), str) and "candidates" in data:
+        plan = data["plan"]
+        lines.append(t(f"GC plan {plan}", f"GC 清单 {plan}"))
+        for row in _rows(data, "candidates")[:_MAX_ROWS]:
+            lines.append(f"  {row.get('id')} · {row.get('path')}")
+        if data.get("dry_run"):
+            lines.append(
+                t(
+                    f"To delete: imagen asset gc --plan {plan} --yes",
+                    f"确认删除：imagen asset gc --plan {plan} --yes",
+                )
+            )
+        else:
+            deleted = data.get("deleted") or []
+            lines.append(t(f"Deleted {len(deleted)} artifacts", f"已删除 {len(deleted)} 个产物"))
+    if "workers" in data:
+        workers = _rows(data, "workers")
+        if not workers:
+            lines.append(t("No worker is running", "没有正在运行的 worker"))
+        for row in workers[:_MAX_ROWS]:
+            lines.append(f"{row.get('id')} · {row.get('state')} · {row.get('pid') or ''}")
+    if "recovered" in data:
+        recovered = data.get("recovered") or []
+        lines.append(
+            t(f"Recovered {len(recovered)} leases", f"接管 {len(recovered)} 个租约")
+            if recovered
+            else t("No expired lease", "没有过期租约")
+        )
+    worker = data.get("worker")
+    if isinstance(worker, dict) and worker.get("id"):
+        lines.append(f"worker {worker.get('id')} · {worker.get('state') or ''}")
+    if isinstance(data.get("archive"), str):
+        lines.append(t(f"Exported to {data['archive']}", f"已导出到 {data['archive']}"))
+        if data.get("turns") is not None:
+            lines.append(
+                f"{data.get('turns')} turns · {data.get('artifacts')} artifacts"
+            )
+    batch = data.get("batch")
+    if isinstance(batch, dict) and batch.get("id"):
+        summary = data.get("summary") or {}
+        state = summary.get("state") or batch.get("state") or ""
+        lines.append(t(f"Batch {batch['id']} · {state}", f"批次 {batch['id']} · {state}"))
+        if summary.get("child_count") is not None:
+            lines.append(
+                t(
+                    f"  {summary.get('complete_success_count')}/{summary.get('child_count')}"
+                    f" complete · {summary.get('saved_artifact_count')} saved",
+                    f"  {summary.get('complete_success_count')}/{summary.get('child_count')}"
+                    f" 完成 · 已保存 {summary.get('saved_artifact_count')}",
+                )
+            )
+        for row in _rows(data, "children")[:_MAX_ROWS]:
+            child = row.get("job_id") or row.get("id") or ""
+            lines.append(f"  {child} · {row.get('state') or row.get('remote_state') or ''}")
+    approval = data.get("approval")
+    if isinstance(approval, dict) and approval.get("plan_id"):
+        lines.append(f"plan {approval.get('plan_id')} · {approval.get('state') or ''}")
+    if isinstance(data.get("model"), str) and data.get("sha256"):
+        lines.append(
+            t(
+                f"Downloaded {data['model']} → {data.get('path')} ({data.get('bytes')} bytes)",
+                f"已下载 {data['model']} → {data.get('path')}（{data.get('bytes')} 字节）",
+            )
+        )
+    return lines
+
+
+def _skill_result_lines(data: dict[str, Any]) -> list[str]:
+    """What `skills install`, `update` and `uninstall` did, one line each."""
+    lines: list[str] = []
+    for row in _rows(data, "installed")[:_MAX_ROWS]:
+        lines.append(
+            t(f"Installed {row.get('name')} → {row.get('path')}",
+              f"已安装 {row.get('name')} → {row.get('path')}")
+        )
+    for row in _rows(data, "removed")[:_MAX_ROWS]:
+        lines.append(
+            t(f"Removed {row.get('name')} ({row.get('path')})",
+              f"已卸载 {row.get('name')}（{row.get('path')}）")
+        )
+    updated = data.get("updated")
+    if isinstance(updated, list) and updated:
+        names = ", ".join(str(name) for name in updated)
+        lines.append(t(f"Updated: {names}", f"已更新：{names}"))
+    current = data.get("current")
+    if isinstance(current, list) and current:
+        names = ", ".join(str(name) for name in current)
+        lines.append(t(f"Already current: {names}", f"已是最新：{names}"))
+    for row in _rows(data, "existing")[:_MAX_ROWS]:
+        lines.append(
+            t(
+                f"Skipped {row.get('name')}: {row.get('path')} exists (add --force to replace)",
+                f"跳过 {row.get('name')}：{row.get('path')} 已存在（加 --force 覆盖）",
+            )
+        )
+    for row in _rows(data, "conflicts")[:_MAX_ROWS]:
+        reason = _conflict_reason(row.get("reason"))
+        lines.append(
+            t(
+                f"Conflict {row.get('name')}: {reason} ({row.get('path')})",
+                f"冲突 {row.get('name')}：{reason}（{row.get('path')}）",
+            )
+        )
+    for row in _rows(data, "failed")[:_MAX_ROWS]:
+        lines.append(
+            t(f"Failed {row.get('name')} ({row.get('path')})",
+              f"失败 {row.get('name')}（{row.get('path')}）")
+        )
+    return lines
+
+
 def _schema_rows(data: dict[str, Any]) -> list[tuple[str, str, str]]:
     schema = data.get("input_schema") or {}
     properties = schema.get("properties") or {}
@@ -260,6 +408,8 @@ def _plain_lines(value: dict[str, Any]) -> list[str]:
         )
         note = t(" · update available", " · 可更新") if stale_any else ""
         lines.append(f"{row.get('name')} · {row.get('version')} · {where}{note}")
+    lines.extend(_skill_result_lines(data))
+    lines.extend(_detail_result_lines(data))
     if data.get("installed") and data.get("latest"):
         state = (
             t("update available", "有可用更新")
@@ -365,6 +515,10 @@ def _error_lines(value: dict[str, Any]) -> list[str]:
         if command:
             lines.append(t(f"Next: {command}", f"下一步：{command}"))
     status = value.get("status", "unknown")
+    data = value.get("data")
+    if isinstance(data, dict):
+        # A conflict still carries what was skipped or refused.
+        lines.extend(_skill_result_lines(data))
     return lines + [t(f"status: {status}", f"状态：{status}")]
 
 
@@ -549,6 +703,12 @@ def _rich(value: dict[str, Any], width: int) -> str:
                 t("yes", "是") if stale_any else t("no", "否"),
             )
         console.print(table)
+    skill_results = _skill_result_lines(data)
+    for line in skill_results:
+        console.print(line)
+    detail_results = _detail_result_lines(data)
+    for line in detail_results:
+        console.print(line)
     if data.get("installed") and data.get("latest"):
         state = (
             t("update available", "有可用更新")
@@ -664,6 +824,9 @@ def _rich(value: dict[str, Any], width: int) -> str:
             artifacts,
             parameters,
             details,
+            skills,
+            skill_results,
+            detail_results,
         )
     ):
         console.print(json.dumps(data, ensure_ascii=False))

{imagen_cli-0.1.2 → imagen_cli-0.1.4}/src/imagen_cli/cli/options.py

@@ -57,6 +57,7 @@ COMMAND_CONTROLS: dict[str, set[str]] = {
     "session remove-image": {"purge"},
     "asset gc": {"dry_run", "yes"},
     "cache purge": {"plan", "yes"},
+    "skills uninstall": {"yes"},
     "transform": {"pipeline", "op", "preset", "session", "timeout"},
     "ops": {"op", "preset", "verbose"},
     "models refresh": {"profile", "send_credential"},

{imagen_cli-0.1.2 → imagen_cli-0.1.4}/src/imagen_cli/cli/renderers.py

@@ -43,7 +43,7 @@ ERROR_REASONS = {
     "validation_error": "the request parameters are invalid",
     "unsupported_capability": "this provider or model does not support the requested capability",
     "not_found": "no matching record exists in this workspace",
-    "conflict": "the record changed since it was read",
+    "conflict": "the command conflicted and changed nothing",
     "wait_timeout": "the job did not finish before the timeout; it may still be running",
     "approval_required": "this step needs an explicit approval first",
     "provider_error": "the provider returned an error",
@@ -60,7 +60,7 @@ ERROR_REASONS_ZH = {
     "validation_error": "请求参数不合法",
     "unsupported_capability": "当前供应商或模型不支持该能力",
     "not_found": "当前工作区中没有匹配的记录",
-    "conflict": "记录在读取后被修改过",
+    "conflict": "命令发生冲突，未做任何改动",
     "wait_timeout": "任务在超时前未结束，可能仍在运行",
     "approval_required": "该步骤需要先显式批准",
     "provider_error": "供应商返回错误",

imagen_cli-0.1.4/src/imagen_cli/cli/selection.py

@@ -0,0 +1,142 @@
+"""Small terminal selector shared by explicit setup commands."""
+
+from __future__ import annotations
+
+import os
+from typing import TextIO
+
+from rich.console import Console
+from rich.live import Live
+from rich.text import Text
+
+from imagen_cli.i18n import t
+
+# Which keys do what; `apply` is pure so the state machine is testable without a TTY.
+_UP = {"\x1b[A", "\x1bOA", "\x00H", "\xe0H", "k"}
+_DOWN = {"\x1b[B", "\x1bOB", "\x00P", "\xe0P", "j"}
+_CONFIRM = {"\r", "\n"}
+_CANCEL = {"\x1b", "q"}
+
+
+def apply(
+    labels: list[str], picked: list[str], cursor: int, key: str
+) -> tuple[list[str], int, bool | None]:
+    """One keystroke of the checklist: (selection, cursor, done)."""
+    if key in _UP:
+        return picked, (cursor - 1) % len(labels), None
+    if key in _DOWN:
+        return picked, (cursor + 1) % len(labels), None
+    if key == " ":
+        name = labels[cursor]
+        if name in picked:
+            return [item for item in picked if item != name], cursor, None
+        return [*picked, name], cursor, None
+    if key == "a":
+        return ([] if len(picked) == len(labels) else list(labels)), cursor, None
+    if key in _CANCEL:
+        return [], cursor, False
+    if key in _CONFIRM:
+        return (picked or [labels[cursor]]), cursor, True
+    return picked, cursor, None
+
+
+def _tty(stream: TextIO) -> bool:
+    try:
+        return stream.isatty()
+    except (AttributeError, ValueError):
+        return False
+
+
+def _read_key(stream: TextIO) -> str:
+    if os.name == "nt":
+        import msvcrt
+
+        getwch = msvcrt.getwch  # type: ignore[attr-defined]  # typeshed omits it off Windows
+        char: str = getwch()
+        return char + (getwch() if char in "\x00\xe0" else "")
+    import select
+    import termios
+    import tty
+
+    descriptor = stream.fileno()
+    settings = termios.tcgetattr(descriptor)
+    try:
+        tty.setcbreak(descriptor, termios.TCSADRAIN)  # TCSAFLUSH drops queued keys
+        # Read the fd, not the text wrapper: its buffer would hide the escape tail.
+        char = os.read(descriptor, 1).decode("utf-8", "replace")
+        if char == "\x1b":
+            for _ in range(2):
+                if not select.select([descriptor], [], [], 0.05)[0]:
+                    break
+                char += os.read(descriptor, 1).decode("utf-8", "replace")
+    finally:
+        termios.tcsetattr(descriptor, termios.TCSADRAIN, settings)
+    return char
+
+
+def _render(labels: list[str], picked: list[str], cursor: int, height: int) -> Text:
+    start = max(0, min(cursor - height // 2, len(labels) - height))
+    body = Text()
+    for index in range(start, min(start + height, len(labels))):
+        name = labels[index]
+        body.append("› " if index == cursor else "  ", style="bold cyan")
+        body.append("◉ " if name in picked else "○ ", style="green" if name in picked else "dim")
+        body.append(name, style="bold" if index == cursor else "")
+        body.append("\n")
+    if start or start + height < len(labels):
+        end = min(start + height, len(labels))
+        body.append(f"  {start + 1}-{end}/{len(labels)}\n", style="dim")
+    body.append(
+        t(
+            "↑/↓ move · space select · a all · enter confirm · q cancel",
+            "↑/↓ 移动 · 空格选择 · a 全选 · 回车确认 · q 取消",
+        ),
+        style="dim",
+    )
+    return body
+
+
+def _pick(numbers: list[str], stdin: TextIO, stderr: TextIO, selected: list[str]) -> list[str]:
+    for index, label in enumerate(numbers, 1):
+        mark = "*" if label in selected else " "
+        stderr.write(f"{index:2}. [{mark}] {label}\n")
+    stderr.write(
+        t(
+            "Enter numbers (comma-separated, blank keeps the starred ones): ",
+            "输入序号（多个用逗号分隔，空白保留带 * 的项）：",
+        )
+    )
+    stderr.flush()
+    value = stdin.readline()
+    if value == "":
+        return []
+    value = value.strip()
+    if not value:
+        return list(selected)
+    try:
+        indices = list(dict.fromkeys(int(item.strip()) - 1 for item in value.split(",")))
+        if any(index < 0 or index >= len(numbers) for index in indices):
+            return []
+        return [numbers[index] for index in indices]
+    except ValueError:
+        return []
+
+
+def choose(
+    labels: list[str], *, stdin: TextIO, stderr: TextIO, selected: list[str] | None = None
+) -> list[str]:
+    """Tick agents in a checklist; `selected` starts ticked."""
+    picked = [label for label in labels if label in (selected or [])]
+    if not _tty(stdin) or not _tty(stderr):
+        return _pick(labels, stdin, stderr, picked)
+    console = Console(file=stderr, force_terminal=True, highlight=False)
+    height = max(5, min(len(labels), console.height - 3))
+    cursor = 0
+    with Live(
+        _render(labels, picked, cursor, height), console=console, transient=True
+    ) as live:
+        while True:
+            picked, cursor, done = apply(labels, picked, cursor, _read_key(stdin))
+            if done is not None:
+                return picked if done else []
+            live.update(_render(labels, picked, cursor, height))

{imagen_cli-0.1.2 → imagen_cli-0.1.4}/tests/contract/test_bundled_skill_guides.py

@@ -6,7 +6,7 @@ from imagen_cli.cli.entrypoint import _parse
 def test_installed_guide_has_workflow_reference(tmp_path, monkeypatch):
     monkeypatch.chdir(tmp_path)
     assert skills_service.install_(["imagen"])[0] == "succeeded"
-    root = tmp_path / ".claude/skills/imagen"
+    root = tmp_path / ".agents/skills/imagen"
     text = (root / "SKILL.md").read_text()
     assert "references/workflows.md" in text
     guide = (root / "references/workflows.md").read_text()

{imagen_cli-0.1.2 → imagen_cli-0.1.4}/tests/integration/test_setup_selection.py

@@ -11,10 +11,16 @@ class Terminal(io.StringIO):
 
 def test_interactive_skills_and_model_cancel(tmp_path, monkeypatch):
     monkeypatch.chdir(tmp_path)
+    monkeypatch.setenv("HOME", str(tmp_path / "home"))
+    monkeypatch.setenv("USERPROFILE", str(tmp_path / "home"))
     monkeypatch.setattr("sys.stdin", Terminal("\n"))
     out, err = Terminal(), io.StringIO()
-    assert main(["skills", "install"], stdout=out, stderr=err) != 0
+    assert main(["skills", "install"], stdout=out, stderr=err) == 0
+    assert (tmp_path / ".agents/skills/imagen/SKILL.md").is_file()
     assert not (tmp_path / ".claude").exists()
+    monkeypatch.setattr("sys.stdin", Terminal(""))
+    out, err = Terminal(), io.StringIO()
+    assert main(["skills", "install", "--skill", "imagen-batch"], stdout=out, stderr=err) != 0
     monkeypatch.setattr("sys.stdin", Terminal("\n"))
     out, err = Terminal(), io.StringIO()
     assert main(["superres", "fetch"], stdout=out, stderr=err) != 0