@freeaiforall/kiro-reg 1.0.0

package/README.md

@@ -0,0 +1,98 @@
+# kiro-reg
+
+Automated AWS Builder ID (Kiro) registration tool with anti-fingerprinting.
+
+> **Platform support: macOS Apple Silicon (arm64) only.**  
+> Intel Mac and Windows are not supported in this release.
+
+---
+
+## Requirements
+
+- macOS on Apple Silicon (M1/M2/M3/M4)
+- Node.js >= 16
+- A local HTTP proxy (e.g. Clash, Surge) running on your machine
+
+---
+
+## Installation
+
+```bash
+npm install -g @freeaiforall/kiro-reg
+```
+
+---
+
+## Quick Start
+
+### 1. Initialize config files
+
+Run `init` in the directory where you want to store your config:
+
+```bash
+cd ~/my-kiro-workspace
+kiro-reg init
+```
+
+This generates two files if they don't already exist:
+
+- `config.toml` — proxy and password settings
+- `emails.txt` — list of emails to register
+
+### 2. Edit `config.toml`
+
+```toml
+# Local HTTP proxy (required — used for WebView and OIDC requests)
+proxy_host = "127.0.0.1"
+proxy_port = "2080"
+
+# Password used for all registered accounts
+password = "YourPassword123!"
+```
+
+| Field        | Description                  | Default       |
+|--------------|------------------------------|---------------|
+| `proxy_host` | Local HTTP proxy address     | `127.0.0.1`   |
+| `proxy_port` | Local HTTP proxy port        | `2080`        |
+| `password`   | Password for all accounts    | _(empty)_     |
+
+> Make sure your proxy is running before launching kiro-reg.
+
+### 3. Edit `emails.txt`
+
+One email per line. Lines starting with `#` are ignored.
+
+```
+# emails to register
+user1@example.com
+user2@example.com
+```
+
+### 4. Run
+
+```bash
+kiro-reg
+```
+
+The tool will:
+1. Pre-fill the first email from `emails.txt` into the input window
+2. Auto-fill name and email on the registration page
+3. Pause at the CAPTCHA step — complete it manually
+4. Auto-fill the password fields — click "Continue" manually to finish
+
+---
+
+## How it works
+
+- Opens a WKWebView window with a fresh browser state (cookies/cache/localStorage cleared on every run)
+- Injects anti-fingerprinting JS to avoid automation detection
+- Uses AWS OIDC device flow to obtain the registration URL
+- Routes through your local HTTP proxy for all network requests
+
+---
+
+## Notes
+
+- Always run `kiro-reg` from the directory containing your `config.toml` and `emails.txt`
+- Step 4 (password) requires a manual click to continue — this is intentional
+- Each run registers one account; edit `emails.txt` and re-run for the next one

package/bin/kiro-reg.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+/**
+ * kiro-reg CLI 入口
+ * 检测当前平台，找到对应预编译二进制并执行
+ */
+
+const { execFileSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const PLATFORMS = {
+  'darwin-arm64': '@freeaiforall/kiro-reg-darwin-arm64',
+  'darwin-x64':   '@freeaiforall/kiro-reg-darwin-x64',
+  'win32-x64':    '@freeaiforall/kiro-reg-win32-x64',
+};
+
+function getBinaryPath() {
+  const platform = process.platform;   // darwin / win32 / linux
+  const arch     = process.arch;       // arm64 / x64
+  const key      = `${platform}-${arch}`;
+  const pkgName  = PLATFORMS[key];
+
+  if (!pkgName) {
+    console.error(`[kiro-reg] 不支持的平台: ${key}`);
+    console.error('支持的平台: macOS arm64, macOS x64, Windows x64');
+    process.exit(1);
+  }
+
+  // 尝试从 optionalDependencies 子包里找二进制
+  try {
+    const pkgDir  = path.dirname(require.resolve(`${pkgName}/package.json`));
+    const binName = platform === 'win32' ? 'kiro-reg.exe' : 'kiro-reg';
+    const binPath = path.join(pkgDir, 'bin', binName);
+    if (fs.existsSync(binPath)) return binPath;
+  } catch (e) {
+    // 子包未安装，继续尝试本地路径
+  }
+
+  console.error(`[kiro-reg] 找不到平台二进制 (${key})，请重新安装: npm install -g kiro-reg`);
+  process.exit(1);
+}
+
+const bin = getBinaryPath();
+
+// 把所有 CLI 参数透传给原生二进制
+try {
+  execFileSync(bin, process.argv.slice(2), {
+    stdio: 'inherit',
+    cwd: process.cwd(),
+  });
+} catch (e) {
+  process.exit(e.status || 1);
+}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@freeaiforall/kiro-reg",
+  "version": "1.0.0",
+  "description": "Automated AWS Builder ID (Kiro) registration tool - macOS Apple Silicon (arm64) only",
+  "bin": {
+    "kiro-reg": "./bin/kiro-reg.js"
+  },
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "optionalDependencies": {
+    "@freeaiforall/kiro-reg-darwin-arm64": "1.0.0"
+  },
+  "keywords": ["kiro", "aws", "builder-id", "registration", "automation", "cli", "macos"],
+  "author": "cn3588",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://gitee.com/llm_xinhai/awsregistool"
+  },
+  "engines": {
+    "node": ">=16"
+  }
+}

package/platforms/kiro-reg-darwin-arm64/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "@freeaiforall/kiro-reg-darwin-arm64",
+  "version": "1.0.0",
+  "description": "kiro-reg binary for macOS Apple Silicon (arm64)",
+  "os": ["darwin"],
+  "cpu": ["arm64"],
+  "main": "bin/kiro-reg",
+  "author": "cn3588",
+  "license": "MIT"
+}

package/platforms/kiro-reg-darwin-x64/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "@freeaiforall/kiro-reg-darwin-x64",
+  "version": "1.0.0",
+  "description": "kiro-reg binary for macOS Intel (x64)",
+  "os": ["darwin"],
+  "cpu": ["x64"],
+  "main": "bin/kiro-reg",
+  "author": "cn3588",
+  "license": "MIT"
+}

package/platforms/kiro-reg-win32-x64/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "@freeaiforall/kiro-reg-win32-x64",
+  "version": "1.0.0",
+  "description": "kiro-reg binary for Windows x64",
+  "os": ["win32"],
+  "cpu": ["x64"],
+  "main": "bin/kiro-reg.exe",
+  "author": "cn3588",
+  "license": "MIT"
+}

package/scripts/postinstall.js

@@ -0,0 +1,44 @@
+/**
+ * postinstall.js
+ * npm install 完成后自动验证平台二进制是否可用
+ */
+
+const path = require('path');
+const fs   = require('fs');
+
+const PLATFORMS = {
+  'darwin-arm64': '@freeaiforall/kiro-reg-darwin-arm64',
+  'darwin-x64':   '@freeaiforall/kiro-reg-darwin-x64',
+  'win32-x64':    '@freeaiforall/kiro-reg-win32-x64',
+};
+
+const platform = process.platform;
+const arch     = process.arch;
+const key      = `${platform}-${arch}`;
+const pkgName  = PLATFORMS[key];
+
+if (!pkgName) {
+  console.warn(`[kiro-reg] 警告：不支持的平台 ${key}，跳过二进制检查`);
+  process.exit(0);
+}
+
+try {
+  const pkgDir  = path.dirname(require.resolve(`${pkgName}/package.json`));
+  const binName = platform === 'win32' ? 'kiro-reg.exe' : 'kiro-reg';
+  const binPath = path.join(pkgDir, 'bin', binName);
+
+  if (!fs.existsSync(binPath)) {
+    console.error(`[kiro-reg] 二进制文件不存在: ${binPath}`);
+    process.exit(1);
+  }
+
+  // macOS/Linux 确保可执行权限
+  if (platform !== 'win32') {
+    fs.chmodSync(binPath, 0o755);
+  }
+
+  console.log(`[kiro-reg] ✓ 安装成功 (${key})`);
+  console.log(`[kiro-reg] 运行 'kiro-reg' 开始使用`);
+} catch (e) {
+  console.warn(`[kiro-reg] 警告：平台子包 ${pkgName} 未找到，可能不支持当前平台`);
+}