alanbox 0.1.1

package/README.md

@@ -0,0 +1,31 @@
+# alanbox
+
+`alanbox` is a local worker orchestration CLI for running isolated Codex or Claude child workers.
+
+The current stable workflow is `swam` / `swarm` from `0commondflowv1`.
+
+## Install
+
+```powershell
+npm install -g alanbox
+```
+
+## Commands
+
+```powershell
+alanbox info
+alanbox doctor
+alanbox install --target codex
+alanbox install --target claude
+alanbox install --target both
+alanbox swam --namespace run-name --worker "codex:reviewer:检查当前改动"
+alanbox swam --namespace run-name --worker "claude:reviewer:检查当前改动"
+```
+
+`multirunagent` remains available as a compatibility bin name.
+
+## Notes
+
+- `install` explicitly copies bundled skills, hooks, scripts, and MCP resource placeholders to Codex and/or Claude homes.
+- `1uiflowv1` measure and `2apiflowv1` getapi are not exposed by this npm package yet.
+- `swam` is a compatibility alias for `swarm`.

package/bin/multirunagent.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+
+/**
+ * multirunagent 的包命令入口。
+ * bin 层保持很薄，只把命令处理交给 0commondflowv1/src/cli.js。
+ */
+
+require('../0commondflowv1/src/cli').main().catch((error) => {
+  console.error(error.message || error);
+  process.exitCode = 1;
+});
+
+
+
+

package/hooks/hooks.json

@@ -0,0 +1,18 @@
+{
+  "description": "Optional Codex hook examples for multirunagent. Keep disabled unless the local Codex hook schema is explicitly configured.",
+  "hooks": {
+    "SessionStart": [
+      {
+        "command": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\scripts\\sub-codex-hook.ps1\" session-start"
+      }
+    ],
+    "SessionEnd": [
+      {
+        "command": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\scripts\\sub-codex-hook.ps1\" session-end"
+      }
+    ]
+  }
+}
+
+
+

package/mcp/README.md

@@ -0,0 +1,5 @@
+# alanbox MCP resources
+
+This directory is reserved for optional alanbox MCP resources.
+
+The installer copies this directory to Codex and Claude resource homes when present. No MCP server is implemented here yet; keep this placeholder so packaged installs still create the target `mcp/alanbox` directory.

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "alanbox",
+  "version": "0.1.1",
+  "description": "Run isolated child Codex or Claude workers with serial, parallel, and auto swarm orchestration.",
+  "main": "0commondflowv1/src/cli.js",
+  "bin": {
+    "alanbox": "bin/multirunagent.js",
+    "multirunagent": "bin/multirunagent.js"
+  },
+  "files": [
+    "bin/**",
+    "0commondflowv1/**",
+    "skills/**",
+    "plugin/**",
+    "hooks/**",
+    "mcp/**",
+    "scripts/**",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "swarm": "node bin/multirunagent.js swarm",
+    "doctor": "node bin/multirunagent.js doctor",
+    "test": "node bin/multirunagent.js --help && node bin/multirunagent.js info",
+    "validate": "node bin/multirunagent.js info"
+  },
+  "keywords": [
+    "codex",
+    "multi-agent",
+    "worker",
+    "swarm",
+    "cli",
+    "plugin",
+    "skills"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}
+

package/plugin/AGENTS.md

@@ -0,0 +1,14 @@
+## alanbox plugin
+
+`C:\Users\lenovo\Desktop\my-project\101my-aitool\aibox\plugin` 存放源码侧 Codex plugin manifest。安装时 `0commondflowv1/src/commands/install.js` 会把本目录复制到用户插件目录的 `plugins/alanbox/.codex-plugin/`，所以源码目录名是 `plugin/`，安装目标目录名才是 `.codex-plugin/`。
+
+**Important:** 这里是 Codex 插件展示与 skill 发现配置，不是 Claude 配置。Claude 侧只复用 `skills/`、`hooks/`、`scripts/`、`mcp/` 资源，不读取 `plugin.json`。
+
+### Important files
+
+- `plugin.json` — Codex plugin manifest；`skills` 必须继续指向 `./skills/`，默认提示词应只描述当前真实入口 `swam`/`swarm`、`info`、`doctor`。
+
+### Implementation notes
+
+- 修改 skill 名称、插件展示文案或 package 分发目录时，同步检查根目录 `package.json.files` 和 `install.js`。
+- 不要在 manifest 里写已经移除的 `exec`、独立 `parallel` 或 `dry-run` 用法。

package/plugin/plugin.json

@@ -0,0 +1,36 @@
+{
+  "name": "alanbox",
+  "version": "0.1.1",
+  "description": "Codex skills for using alanbox to run isolated Codex or Claude child workers.",
+  "author": {
+    "name": "local"
+  },
+  "license": "MIT",
+  "keywords": [
+    "codex",
+    "sub-agent",
+    "worker",
+    "swarm",
+    "automation"
+  ],
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "alanbox",
+    "shortDescription": "Use alanbox swam/swarm to run child Codex or Claude workers.",
+    "longDescription": "Provides concise skills that explain how to call alanbox for swam/swarm, parallel worker scheduling, auto workflow, and doctor checks.",
+    "developerName": "local",
+    "category": "Productivity",
+    "capabilities": [
+      "Write",
+      "Automation"
+    ],
+    "defaultPrompt": [
+      "Use alanbox swam to run one child Codex worker.",
+      "Use alanbox swam to run one child Claude worker.",
+      "Plan a serial swam workflow for this task."
+    ]
+  }
+}
+
+
+

package/scripts/sub-codex-hook.ps1

@@ -0,0 +1,15 @@
+param(
+  [string]$EventName = "unknown"
+)
+
+$Root = Split-Path -Parent (Split-Path -Parent $MyInvocation.MyCommand.Path)
+$LogDir = Join-Path $Root ".sub-codex-hooks"
+$LogPath = Join-Path $LogDir "events.log"
+
+New-Item -ItemType Directory -Force -Path $LogDir | Out-Null
+$Line = "$(Get-Date -Format o) $EventName"
+Add-Content -LiteralPath $LogPath -Encoding UTF8 -Value $Line
+Write-Output $Line
+
+
+

package/skills/AGENTS.md

@@ -0,0 +1,17 @@
+## aibox skills
+
+`C:\Users\lenovo\Desktop\my-project\101my-aitool\aibox\skills` 存放随 `alanbox` 分发的 agent skills。当前只描述 `0commondflowv1` 的 `swam`/`swarm`、`info` 和 `doctor` 用法；不要在这里接入 `1uiflowv1` 的 measure 或 `2apiflowv1` 的 getapi，除非用户重新明确要求。
+
+**Important:** skills 只写调用 workflow，不实现业务逻辑。发布包中的示例优先使用 `alanbox ...`；本地源码调试才使用 `node bin/multirunagent.js ...`。
+
+### Important files
+
+- `aibox-swam/SKILL.md` — 通用 swam workflow skill；同时适用于 Codex 和 Claude，示例应覆盖 `codex:` 与 `claude:` worker。
+- `sub-codex-swarm/SKILL.md` — 兼容旧触发名的 swarm skill；保留但内容必须和当前 `swam`/`swarm` CLI 行为一致。
+- `sub-codex-doctor/SKILL.md` — 诊断 skill；只指导调用 `info` 和 `doctor`。
+
+### Implementation notes
+
+- 新增或修改 CLI 参数时，同步检查对应 `SKILL.md` 示例。
+- `install` 会把本目录中含 `SKILL.md` 的子目录安装到 Codex 的 `~/.codex/skills`，以及 Claude 的 `~/.claude/skill`。
+- 不要把一次性本机 runId、账号、token、私有服务地址写进 skill。

package/skills/aibox-swam/SKILL.md

@@ -0,0 +1,77 @@
+---
+name: aibox-swam
+description: 当 Codex 或 Claude 需要通过 alanbox 调用 swam/swarm 执行 Codex 或 Claude 子 worker 时使用。
+---
+
+# aibox swam workflow
+
+本 skill 只负责指导调用 alanbox 的 `swam`/`swarm` 命令。真实执行由 CLI 完成；不要在 skill 内复制实现逻辑。
+
+## 入口
+
+```powershell
+alanbox swam --namespace run-name --worker "codex:reviewer:检查当前改动"
+```
+
+`swam` 是 `swarm` 的兼容别名；两者走同一条执行链路。
+
+## 调用 Codex worker
+
+```powershell
+alanbox swam --namespace codex-check --worker "codex:reviewer:复核 src 目录的正确性问题"
+```
+
+## 调用 Claude worker
+
+```powershell
+alanbox swam --namespace claude-check --worker "claude:reviewer:复核 src 目录的正确性问题"
+```
+
+## 串行和并行
+
+后一个 worker 需要读取前一个 worker 的结论时，重复传 `--worker`：
+
+```powershell
+alanbox swam --namespace staged-review --worker "codex:lead:先分析问题范围" --worker "claude:reviewer:基于上游结论复核"
+```
+
+多个 worker 可以独立执行时，使用 `--parallel-workers`：
+
+```powershell
+alanbox swam --namespace parallel-review --parallel-workers --worker "codex:a:检查前端" --worker "claude:b:检查脚本"
+```
+
+混合串行/并行阶段时，用方括号表示同一阶段并行：
+
+```powershell
+alanbox swam --namespace mixed-review --worker "codex:lead:先拆分任务" --worker "[codex:frontend:检查前端,claude:backend:检查后端]" --worker "codex:summary:汇总结论"
+```
+
+## 自动 workflow
+
+需要 CLI 先推荐 workflow，再确认执行时：
+
+```powershell
+alanbox swam --auto "检查这个项目的主要风险" -a "codex:reviewer:检查代码正确性" -a "claude:reviewer:检查可维护性" -p "优先按目录拆分"
+```
+
+非交互恢复待执行 workflow：
+
+```powershell
+alanbox swam --resume <runId> --namespace <namespace> -y
+```
+
+## 读取结果
+
+```text
+%USERPROFILE%\.multirunagent\<namespace>\results\
+%USERPROFILE%\.multirunagent\<namespace>\memory\index.json
+%USERPROFILE%\.multirunagent\<namespace>\runs\<runId>\
+```
+
+如果只是诊断配置，先用：
+
+```powershell
+alanbox info
+alanbox doctor
+```

package/skills/sub-codex-doctor/SKILL.md

@@ -0,0 +1,27 @@
+---
+name: sub-codex-doctor
+description: 当 Codex 或 Claude 需要检查或诊断本地 alanbox 包、worker 配置、账户主目录、CLI 命令路径、沙箱或子 worker 健康状况时使用。
+---
+
+# alanbox 诊断（Doctor）
+
+检查已解析的配置：
+
+```powershell
+alanbox info
+```
+
+通过 alanbox 运行 provider CLI 健康检查：
+
+```powershell
+alanbox doctor
+```
+
+指定某个账户或 worker：
+
+```powershell
+alanbox info --worker worker-e7
+alanbox doctor --account codex-19b
+```
+
+修改配置前优先运行 `info`。当子 Codex 命令、鉴权、网络、MCP 或状态存储可能出现故障时，使用 `doctor`。

package/skills/sub-codex-swarm/SKILL.md

@@ -0,0 +1,56 @@
+---
+name: sub-codex-swarm
+description: 当 Codex 或 Claude 需要使用 alanbox 的 swam/swarm 串行、并行或自动 GOAP 工作流规划，并在真实子 worker 运行前进行确认时使用。
+---
+
+# alanbox 集群（swam/swarm）
+
+当后续 worker 必须基于先前结果展开时，使用串行 swarm：
+
+```powershell
+alanbox swam --namespace run-name --worker "codex:lead:主分析任务" --worker "claude:reviewer:基于上游结果复核"
+```
+
+`swam` 是 `swarm` 的兼容别名，两者走同一条执行链路。
+
+需要混合串行和并行阶段时，在一个 `--worker` 参数中用方括号包住同一阶段的多个 worker：
+
+```powershell
+alanbox swam --namespace run-name --worker "codex:a:先分析 A" --worker "[codex:c:并行检查 C,claude:d:并行检查 D]" --worker "codex:e:基于 C 和 D 汇总"
+```
+
+上例执行顺序是 `a -> [c,d] -> e`。方括号内用英文逗号分隔；如果 prompt 里必须出现字面逗号，写成 `\,`。
+
+Worker 规格格式：
+
+```text
+<worker-or-platform>:<role>:<prompt>
+```
+
+当用户给出自然语言目标、并希望 CLI 先推荐一个工作流时，使用自动工作流：
+
+```powershell
+alanbox swam --auto "帮我检查我的项目有问题" -a "codex:reviewer:复核当前项目代码" -a "claude:reviewer:复核可维护性" -p "最好每个子文件夹一个子agent并行"
+```
+
+自动工作流规则：
+
+- `swam` 作为 `swarm` 的兼容别名被接受。
+- 在 `swarm --auto` 中，`-a` / `--agent` 是可重复的 agent 规格；如需隔离账户，使用 `--account`。
+- 在 `swarm --auto` 中，`-p` / `--plan-hint` 是规划指引；如需 Codex profile，使用 `--profile`。
+- auto workflow 会调用真实 provider（已无 dry-run 预览）；不带 `-y` 时，CLI 会先推荐工作流并等待确认后才运行真实 worker。
+- 在非交互模式下，可通过以下方式恢复一个待处理的运行：
+
+```powershell
+alanbox swam --resume <runId> --namespace <namespace> -y
+```
+
+真实运行后读取输出：
+
+```text
+%USERPROFILE%\.multirunagent\<namespace>\results\
+%USERPROFILE%\.multirunagent\<namespace>\memory\index.json
+%USERPROFILE%\.multirunagent\<namespace>\runs\<runId>\
+```
+
+当 worker B 需要 worker A 的结论时，使用普通 `swam`/`swarm`；只有全部 worker 都彼此独立时才加 `--parallel-workers`。混合串行/并行阶段用方括号分组。Skill 仅指导 CLI 的用法；所有实际执行都由 CLI 完成。