auriga-cli 1.30.2 → 1.30.4

package/README.md

@@ -6,6 +6,12 @@ A modular Claude Code harness — install only the parts you need.
 
 This repo itself is a fully configured harness project. You can clone it to see the full setup, or use the CLI to install individual modules into your own project.
 
+Auriga's harness design is inspired by several open-source skill and agent-workflow projects:
+
+- [obra/superpowers skills](https://github.com/obra/superpowers/tree/main/skills)
+- [addyosmani/agent-skills](https://github.com/addyosmani/agent-skills)
+- [mattpocock/skills](https://github.com/mattpocock/skills/tree/main)
+
 ## What's Included
 
 | Module | Description |
@@ -17,23 +23,21 @@ This repo itself is a fully configured harness project. You can clone it to see
 
 ## Quick Start
 
-### Ask your Agent to install
-
-The easiest path is to let your current Agent read the install guide and follow it:
-
-> Run `npx -y auriga-cli guide`, read the guide, then install the Auriga harness into this repository by following the steps it prints.
+### Install
 
-The guide command is intentionally non-interactive. It gives the Agent the prerequisite checks, catalog inspection commands, install commands, reload step, and verification checklist in one place.
+There are two recommended ways to install:
 
-### Agent Bootstrap (non-TTY)
-
-Running inside `claude -p`, `claude -p --worktree`, or any non-interactive Agent session? Start here:
+1. Run the installer yourself:
 
 ```bash
-npx -y auriga-cli guide
+npx -y auriga-cli
 ```
 
-This prints a 5-step SOP (prerequisite check → `install --preset` → optional recommended skills → session reload → verify). Follow it top-to-bottom and the Agent can install the full harness without any human prompt.
+2. In an interactive Agent session, ask the Agent:
+
+> Run `npx -y auriga-cli guide`, read the guide, then install the Auriga harness into this repository by following the steps it prints.
+
+The guide command is intentionally non-interactive so an Agent can read the prerequisite checks, catalog inspection commands, install commands, reload step, and verification checklist in one place.
 
 The leading `-y` belongs to `npx` (it auto-confirms package installation), **not** to `auriga-cli`.
 
@@ -52,7 +56,7 @@ npx -y auriga-cli --help                     # full catalog + flags
 
 `--preset` is atomic — it cannot be combined with a `<type>` or any filter flag, but it accepts `--scope`, `--agent`, and `--lang` (preset defaults: `user` / `both` / `zh-CN`, which differ from the per-category defaults).
 
-Exit codes: `0` success, `1` fatal (precheck / parse / fetch), `2` partial success — `stderr` lists per-category `[OK]/[FAIL]` and a `Retry:` hint. After install, reload the Claude Code or Codex session so the new `AGENTS.md` / skills / plugins / hook-plugin registrations are picked up.
+Exit codes: `0` success, `1` fatal (precheck / parse / fetch), `2` partial success — `stderr` lists per-category `[OK]/[FAIL]` and a `Retry:` hint. After install, reload the Agent session so the new `AGENTS.md` / skills / plugins / hook-plugin registrations are picked up.
 
 ### Web UI (opt-in)
 

package/README.zh-CN.md

@@ -6,6 +6,12 @@
 
 这个仓库本身就是一个完整配置好的 harness 项目。可以直接 clone 查看完整配置，也可以用 CLI 把各模块安装到你自己的项目中。
 
+Auriga 的 harness 设计受以下几个开源 skill 与 Agent 工作流项目启发：
+
+- [obra/superpowers skills](https://github.com/obra/superpowers/tree/main/skills)
+- [addyosmani/agent-skills](https://github.com/addyosmani/agent-skills)
+- [mattpocock/skills](https://github.com/mattpocock/skills/tree/main)
+
 ## 包含什么
 
 | 模块 | 说明 |
@@ -17,23 +23,21 @@
 
 ## 快速开始
 
-### 让你的 Agent 负责安装
-
-最简单的方式是让当前 Agent 先读取安装指南，再按指南执行：
-
-> 运行 `npx -y auriga-cli guide`，阅读指南，然后按输出步骤把 Auriga harness 安装到当前仓库。
+### 安装
 
-`guide` 命令是非交互式的。它会把前置检查、catalog 查看命令、安装命令、重启会话步骤和验证清单一次性提供给 Agent。
+推荐安装方式有两种：
 
-### Agent Bootstrap（非交互）
-
-在 `claude -p`、`claude -p --worktree` 或任何非交互 Agent 会话里想装整套 harness？从这里开始：
+1. 用户自己在命令行运行安装器：
 
 ```bash
-npx -y auriga-cli guide
+npx -y auriga-cli
 ```
 
-会打印一份 5 步 SOP（前置检查 → `install --preset` → 可选 recommended skills → 重启 session → 验证）。Agent 照着顺序往下跑就能装完整套 harness，全程不需要人按键。
+2. 在交互式 Agent 会话里输入提示词：
+
+> 运行 `npx -y auriga-cli guide`，阅读指南，然后按输出步骤把 Auriga harness 安装到当前仓库。
+
+`guide` 命令是非交互式的，方便 Agent 一次性读取前置检查、catalog 查看命令、安装命令、重启会话步骤和验证清单。
 
 开头的 `-y` 是 **npx 自己的 flag**（用来跳过"是否要装这个包"的确认），**不是** auriga-cli 的参数。
 
@@ -52,7 +56,7 @@ npx -y auriga-cli --help                     # 完整 catalog + flag 说明
 
 `--preset` 是原子标志 —— 不能与 `<type>` 或任何过滤标志同时使用,但可带 `--scope`、`--agent`、`--lang`(预设默认 `user` / `both` / `zh-CN`,与分类安装的默认不同)。
 
-退出码：`0` 成功；`1` 致命错误（前置检查 / 解析 / 拉取失败）；`2` 部分成功——`stderr` 会列出逐类 `[OK]/[FAIL]` 和 `Retry:` 提示。装完后请重启 Claude Code 或 Codex 会话，让新的 `AGENTS.md` / skills / plugins / hook 插件注册生效。
+退出码：`0` 成功；`1` 致命错误（前置检查 / 解析 / 拉取失败）；`2` 部分成功——`stderr` 会列出逐类 `[OK]/[FAIL]` 和 `Retry:` 提示。装完后请重启 Agent 会话，让新的 `AGENTS.md` / skills / plugins / hook 插件注册生效。
 
 ### Web UI（可选）
 

package/dist/catalog.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-05-21T07:29:20.581Z",
+  "generatedAt": "2026-05-29T06:51:16.440Z",
   "workflowSkills": [
     {
       "name": "planning-with-files",

package/dist/cli.js

@@ -11,7 +11,7 @@ import { loadCatalog } from "./catalog.js";
 import { renderHelp, renderTypeHelp } from "./help.js";
 import { renderGuide } from "./guide.js";
 import { CATEGORY_NAMES } from "./types.js";
-const RELOAD_REMINDER = "\n⚠ Reload your Claude Code or Codex session to pick up the new harness (AGENTS.md / skills / plugins are loaded at session startup).\n";
+const RELOAD_REMINDER = "\n⚠ Reload your Agent session to pick up the new harness (AGENTS.md / skills / plugins are loaded at session startup).\n";
 const CATEGORY_SET = new Set(CATEGORY_NAMES);
 const TYPE_FOR_FILTER = {
     "--skill": "skills",

package/dist/guide.d.ts

@@ -3,7 +3,7 @@ export interface GuideOpts {
     version: string;
 }
 /**
- * Renders the Agent-bootstrap SOP per spec §3.6. Plain-text when
+ * Renders the interactive Agent install guide. Plain-text when
  * `color: false`; adds ANSI escapes for headings / command examples
  * / warnings when `color: true`. Color detection happens at the call
  * site (`process.stdout.isTTY && !process.env.NO_COLOR`); this

package/dist/guide.js

@@ -7,7 +7,7 @@ function c(color, code, text) {
     return color ? `${code}${text}${RESET}` : text;
 }
 /**
- * Renders the Agent-bootstrap SOP per spec §3.6. Plain-text when
+ * Renders the interactive Agent install guide. Plain-text when
  * `color: false`; adds ANSI escapes for headings / command examples
  * / warnings when `color: true`. Color detection happens at the call
  * site (`process.stdout.isTTY && !process.env.NO_COLOR`); this
@@ -19,9 +19,12 @@ export function renderGuide(opts) {
     const warn = (s) => c(opts.color, YELLOW, s);
     return `${h(`# auriga-cli bootstrap SOP (v${opts.version})`)}
 
-This guide walks an Agent through installing the auriga harness
+This guide helps an interactive Agent install the auriga harness
 (AGENTS.md + skills + plugins) into the current repository.
 
+It is meant to be read by an Agent after the user asks it to install
+Auriga from an interactive session.
+
 Run each step in order. If any step fails with exit 1, stop and report.
 If exit 2, see stderr for per-category status and follow the "Retry"
 hint.
@@ -95,13 +98,12 @@ Exit codes:
   2  — partial success. stderr lists per-category status. Retry only the
        failed category (the retry line is printed verbatim on stderr).
 
-${h("## Step 4 — Reload session (REQUIRED when installed non-interactively)")}
+${h("## Step 4 — Reload session after install")}
 
 ${warn("⚠")} AGENTS.md, .agents/skills/, and plugin enablement /
-registrations are loaded at session startup. If you ran
-\`npx -y auriga-cli install\` inside an existing Claude Code or Codex session
-(e.g., \`claude -p\` / \`claude -p --worktree\` / \`codex exec\`), the current session
-will NOT see the new harness.
+registrations are loaded at session startup. If you installed Auriga
+from an existing Agent session, the current session will NOT see the new
+harness until it is reloaded.
 
 Action:
   - Commit any in-flight work first

package/dist/help.js

@@ -8,7 +8,7 @@ export function renderHelp(catalog, version) {
     return `auriga-cli v${version} — install Claude Code harness modules
 
 USAGE
-  npx auriga-cli guide                                   Agent bootstrap SOP (start here)
+  npx auriga-cli guide                                   interactive Agent install guide
   npx auriga-cli install                                 (TTY only) checkbox menu
   npx auriga-cli install --preset [--scope <s>] [--agent <a>] [--lang <code>]
                                                          curated default set: workflow doc
@@ -24,7 +24,7 @@ USAGE
                                                          open the local Web UI (spec §4)
   npx auriga-cli --help
 
-  For non-interactive (Agent) use, prepend npx's own -y flag:
+  For copy-paste or Agent use, prepend npx's own -y flag:
     npx -y auriga-cli guide
     npx -y auriga-cli install --preset
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "auriga-cli",
-  "version": "1.30.2",
+  "version": "1.30.4",
   "description": "Interactive CLI to install Claude Code harness modules (Workflow, Skills, Recommended Skills, Plugins)",
   "license": "MIT",
   "repository": {