relayax-cli 0.3.45 → 0.3.48

package/dist/commands/package.js

@@ -298,6 +298,18 @@ function registerPackage(program) {
                     });
                 }
             }
+            // 마운트 경로 스캔 (Cowork/sandbox 환경)
+            for (const { tool, basePath } of (0, ai_tools_js_1.detectMountedCLIs)()) {
+                const items = (0, ai_tools_js_1.scanMountedItems)(basePath, tool);
+                if (items.length > 0) {
+                    sources.push({
+                        path: `${basePath}/${tool.skillsDir}`,
+                        location: 'global',
+                        name: `${tool.name} (mounted)`,
+                        items,
+                    });
+                }
+            }
             // ~/.relay/agents/ 에 기존 에이전트 패키지가 있는지 스캔
             const globalAgentsDir = path_1.default.join(homeDir ?? os_1.default.homedir(), '.relay', 'agents');
             const existingAgents = [];

package/dist/lib/ai-tools.d.ts

@@ -12,6 +12,18 @@ export declare const AI_TOOLS: AITool[];
  * 프로젝트 디렉토리에서 에이전트 CLI 디렉토리를 감지한다.
  */
 export declare function detectAgentCLIs(projectPath: string): AITool[];
+/**
+ * Cowork/sandbox 환경의 마운트 경로 후보를 반환한다.
+ * /sessions/<id>/mnt/ 같은 경로에 실제 파일이 마운트됨.
+ */
+export declare function detectMountPaths(): string[];
+/**
+ * 마운트 경로에서 에이전트 CLI 디렉토리를 감지한다.
+ */
+export declare function detectMountedCLIs(): {
+    tool: AITool;
+    basePath: string;
+}[];
 /**
  * 홈 디렉토리에서 글로벌 에이전트 CLI 디렉토리를 감지한다.
  * ~/{skillsDir}/ 가 존재하는 CLI를 반환.
@@ -32,3 +44,7 @@ export declare function scanLocalItems(projectPath: string, tool: AITool): Conte
  * 글로벌 홈 디렉토리 소스의 개별 스킬/에이전트/커맨드/룰 항목을 반환한다.
  */
 export declare function scanGlobalItems(tool: AITool, home?: string): ContentItem[];
+/**
+ * 마운트 경로의 개별 스킬/에이전트/커맨드/룰 항목을 반환한다.
+ */
+export declare function scanMountedItems(basePath: string, tool: AITool): ContentItem[];

package/dist/lib/ai-tools.js

@@ -5,9 +5,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AI_TOOLS = void 0;
 exports.detectAgentCLIs = detectAgentCLIs;
+exports.detectMountPaths = detectMountPaths;
+exports.detectMountedCLIs = detectMountedCLIs;
 exports.detectGlobalCLIs = detectGlobalCLIs;
 exports.scanLocalItems = scanLocalItems;
 exports.scanGlobalItems = scanGlobalItems;
+exports.scanMountedItems = scanMountedItems;
 const fs_1 = __importDefault(require("fs"));
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
@@ -47,6 +50,31 @@ exports.AI_TOOLS = [
 function detectAgentCLIs(projectPath) {
     return exports.AI_TOOLS.filter((tool) => fs_1.default.existsSync(path_1.default.join(projectPath, tool.skillsDir)));
 }
+/**
+ * Cowork/sandbox 환경의 마운트 경로 후보를 반환한다.
+ * /sessions/<id>/mnt/ 같은 경로에 실제 파일이 마운트됨.
+ */
+function detectMountPaths() {
+    const home = os_1.default.homedir();
+    const mntPath = path_1.default.join(home, 'mnt');
+    if (!fs_1.default.existsSync(mntPath))
+        return [];
+    return [mntPath];
+}
+/**
+ * 마운트 경로에서 에이전트 CLI 디렉토리를 감지한다.
+ */
+function detectMountedCLIs() {
+    const results = [];
+    for (const mnt of detectMountPaths()) {
+        for (const tool of exports.AI_TOOLS) {
+            if (fs_1.default.existsSync(path_1.default.join(mnt, tool.skillsDir))) {
+                results.push({ tool, basePath: mnt });
+            }
+        }
+    }
+    return results;
+}
 /**
  * 홈 디렉토리에서 글로벌 에이전트 CLI 디렉토리를 감지한다.
  * ~/{skillsDir}/ 가 존재하는 CLI를 반환.
@@ -100,3 +128,9 @@ function scanGlobalItems(tool, home) {
     const basePath = path_1.default.join(home ?? os_1.default.homedir(), tool.skillsDir);
     return scanItemsIn(basePath);
 }
+/**
+ * 마운트 경로의 개별 스킬/에이전트/커맨드/룰 항목을 반환한다.
+ */
+function scanMountedItems(basePath, tool) {
+    return scanItemsIn(path_1.default.join(basePath, tool.skillsDir));
+}

package/dist/lib/config.js

@@ -22,7 +22,7 @@ const path_1 = __importDefault(require("path"));
 const os_1 = __importDefault(require("os"));
 const ai_tools_js_1 = require("./ai-tools.js");
 exports.API_URL = 'https://www.relayax.com';
-const GLOBAL_RELAY_DIR = path_1.default.join(os_1.default.homedir(), '.relay');
+const GLOBAL_RELAY_DIR = path_1.default.join(process.env.RELAY_HOME ?? os_1.default.homedir(), '.relay');
 /**
  * 설치 경로를 결정한다.
  * 1. --path 옵션이 있으면 그대로 사용
@@ -31,17 +31,18 @@ const GLOBAL_RELAY_DIR = path_1.default.join(os_1.default.homedir(), '.relay');
  */
 function getInstallPath(override) {
     if (override) {
+        const homeDir = process.env.RELAY_HOME ?? os_1.default.homedir();
         const resolved = override.startsWith('~')
-            ? path_1.default.join(os_1.default.homedir(), override.slice(1))
+            ? path_1.default.join(homeDir, override.slice(1))
             : path_1.default.resolve(override);
         return resolved;
     }
-    const cwd = process.cwd();
-    const detected = (0, ai_tools_js_1.detectAgentCLIs)(cwd);
+    const projectRoot = getProjectRoot();
+    const detected = (0, ai_tools_js_1.detectAgentCLIs)(projectRoot);
     if (detected.length >= 1) {
-        return path_1.default.join(cwd, detected[0].skillsDir);
+        return path_1.default.join(projectRoot, detected[0].skillsDir);
     }
-    return cwd;
+    return projectRoot;
 }
 /** ~/.relay/ — 글로벌 (token, CLI cache) */
 function ensureGlobalRelayDir() {
@@ -49,9 +50,13 @@ function ensureGlobalRelayDir() {
         fs_1.default.mkdirSync(GLOBAL_RELAY_DIR, { recursive: true });
     }
 }
+/** 프로젝트 루트 경로 (RELAY_PROJECT_PATH > cwd) */
+function getProjectRoot() {
+    return process.env.RELAY_PROJECT_PATH ?? process.cwd();
+}
 /** cwd/.relay/ — 프로젝트 로컬 (installed.json, agents/) */
 function ensureProjectRelayDir() {
-    const dir = path_1.default.join(process.cwd(), '.relay');
+    const dir = path_1.default.join(getProjectRoot(), '.relay');
     if (!fs_1.default.existsSync(dir)) {
         fs_1.default.mkdirSync(dir, { recursive: true });
     }
@@ -90,7 +95,7 @@ function saveToken(token) {
     fs_1.default.writeFileSync(tokenFile, JSON.stringify({ access_token: token }), { mode: 0o600 });
     fs_1.default.chmodSync(tokenFile, 0o600);
 }
-const LOCK_FILE = path_1.default.join(os_1.default.homedir(), '.relay', '.token.lock');
+const LOCK_FILE = path_1.default.join(GLOBAL_RELAY_DIR, '.token.lock');
 const LOCK_TIMEOUT = 15000; // 15s
 /**
  * 파일 기반 lock — 여러 CLI 프로세스가 동시에 refresh하는 것을 방지.
@@ -154,6 +159,9 @@ async function doRefresh(refreshToken) {
  * - refresh 실패해도 access_token이 아직 유효하면 계속 사용
  */
 async function getValidToken() {
+    // RELAY_TOKEN 환경변수가 있으면 최우선 사용 (sandbox/CI 환경)
+    if (process.env.RELAY_TOKEN)
+        return process.env.RELAY_TOKEN;
     // 매번 파일에서 새로 읽음 (다른 프로세스가 갱신했을 수 있으므로)
     const data = loadTokenData();
     if (!data)
@@ -218,7 +226,7 @@ function normalizeInstalledRegistry(raw) {
 }
 /** 프로젝트 로컬 installed.json 읽기 */
 function loadInstalled() {
-    const file = path_1.default.join(process.cwd(), '.relay', 'installed.json');
+    const file = path_1.default.join(getProjectRoot(), '.relay', 'installed.json');
     if (!fs_1.default.existsSync(file)) {
         return {};
     }
@@ -232,7 +240,7 @@ function loadInstalled() {
 /** 프로젝트 로컬 installed.json 쓰기 */
 function saveInstalled(registry) {
     ensureProjectRelayDir();
-    const file = path_1.default.join(process.cwd(), '.relay', 'installed.json');
+    const file = path_1.default.join(getProjectRoot(), '.relay', 'installed.json');
     fs_1.default.writeFileSync(file, JSON.stringify(registry, null, 2));
 }
 // ─── 글로벌 레지스트리 ───

package/dist/lib/guide.js

@@ -80,18 +80,17 @@ ${commands.map((cmd) => `- \`/${cmd.name}\`: ${cmd.description}`).join('\n')}
 > ${config.description}
 
 이 가이드는 Relay 에이전트를 설치하는 절차입니다.
-각 Step의 명령어를 순서대로 실행하세요. 요약하지 말고 바로 Step 1부터 시작하세요.
+각 Step의 명령어를 순서대로 실행하세요. 요약하지 말고 바로 Step 0(환경 감지)부터 시작하세요.
 
-터미널(bash)을 실행할 수 없는 환경이라면, 아래 도구에서 이 URL을 열고 실행하세요:
-Claude Code · Claude Cowork · Codex · Cursor · Antigravity
+${index_js_1.SETUP_ENVIRONMENT}
 
 ${setupSection}
 
 ## Step ${installStepNum}. 에이전트 설치
 
-\`\`\`bash
-relay install ${scopedSlug}
-\`\`\`
+감지된 환경에 맞게 실행하세요:
+- 환경 A (터미널): \`relay install ${scopedSlug}\`
+- 환경 B (샌드박스): \`npx relayax-cli install ${scopedSlug}\`
 
 설치 후 아래 의존성을 확인하고 환경을 구성합니다.
 

package/dist/prompts/_setup-cli.md

@@ -1,9 +1,17 @@
-## Step 1. Relay CLI 설치
+## Step 1. Relay CLI 준비
 
-relay CLI가 설치되어 있지 않다면:
+### 환경 A (터미널)
 
 ```bash
 npm install -g relayax-cli
+relay init
+```
+
+이미 설치되어 있다면 최신 버전으로 업데이트합니다:
+
+```bash
+npm update -g relayax-cli
+relay init
 ```
 
 Node.js가 없는 경우:
@@ -11,16 +19,12 @@ Node.js가 없는 경우:
 - Windows: `winget install OpenJS.NodeJS.LTS`
 - Linux: `curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash && source ~/.bashrc && nvm install --lts`
 
-npm 권한 오류 시:
-```bash
-mkdir -p ~/.npm-global && npm config set prefix '~/.npm-global'
-echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc && source ~/.zshrc
-npm install -g relayax-cli
-```
+### 환경 B (샌드박스)
 
-이미 설치되어 있다면 최신 버전으로 업데이트하고 init을 재실행합니다:
+설치 없이 `npx`로 실행합니다. 이후 모든 `relay` 명령어를 `npx relayax-cli`로 대체하세요.
 
 ```bash
-npm update -g relayax-cli
-relay init
+npx relayax-cli --version
 ```
+
+정상 출력되면 준비 완료입니다.

package/dist/prompts/_setup-environment.md

@@ -0,0 +1,32 @@
+## Step 0. 환경 감지
+
+이 가이드는 여러 환경에서 실행될 수 있습니다. 아래 환경 감지를 먼저 수행하고, 이후 모든 Step에서 감지된 환경에 맞는 방법을 사용하세요.
+
+### 환경 판별
+
+```bash
+which relay 2>/dev/null && echo "cli-ok" || echo "cli-missing"
+```
+
+- `cli-ok` → **환경 A (터미널 + CLI 설치됨)** — 바로 Step 1로
+- `cli-missing` → 아래 확인:
+
+```bash
+npm install -g relayax-cli 2>/dev/null && echo "install-ok" || echo "sandbox"
+```
+
+- `install-ok` → **환경 A (터미널)** (`relay init` 실행 후 Step 1로)
+- `sandbox` → **환경 B (샌드박스)** — `npx relayax-cli`로 실행
+
+### 환경별 실행 방법
+
+이후 가이드의 모든 `relay <명령어>`는 감지된 환경에 따라 실행합니다:
+
+| 가이드 지시 | A. 터미널 | B. 샌드박스 |
+|---|---|---|
+| "relay whoami" | `relay whoami` | `npx relayax-cli whoami` |
+| "relay install X" | `relay install X` | `npx relayax-cli install X` |
+| "relay publish" | `relay publish` | `npx relayax-cli publish` |
+| "relay login" | `relay login` | `npx relayax-cli login --device` |
+
+처음 판별한 환경을 이후 계속 사용합니다.

package/dist/prompts/_setup-login.md

@@ -1,35 +1,29 @@
 ## Step 2. 로그인
 
-먼저 `relay whoami`로 로그인 상태를 확인합니다. 이미 로그인되어 있으면 이 단계를 건너뛰세요.
+먼저 로그인 상태를 확인합니다. 이미 로그인되어 있으면 이 단계를 건너뛰세요.
 
-로그인이 필요하면 아래 두 방법 중 하나를 사용하세요.
+- 환경 A: `relay whoami`
+- 환경 B: `npx relayax-cli whoami`
 
-### 방법 A: 브라우저 콜백 (로컬 터미널)
+로그인이 필요하면 아래 방법 중 환경에 맞는 것을 사용하세요.
 
-로컬 머신에서 직접 터미널을 사용하는 경우 이 방법을 사용합니다.
-`relay login`은 로컬 콜백 서버를 띄우고 브라우저 로그인 완료를 기다립니다.
-반드시 포그라운드에서 실행하고, timeout을 300초(5분) 이상으로 설정하세요.
+### 방법 1: 브라우저 콜백 (환경 A — 로컬 터미널)
 
 ```bash
 relay login
 ```
 
 - 브라우저가 자동으로 열리면 GitHub 또는 카카오 계정으로 로그인합니다.
-- 브라우저가 열리지 않으면 CLI 출력에서 로그인 URL을 찾아 별도 명령어로 엽니다: `open <URL>` (macOS) / `xdg-open <URL>` (Linux)
+- 브라우저가 열리지 않으면 출력된 URL을 별도로 엽니다: `open <URL>` (macOS) / `xdg-open <URL>` (Linux)
 
 "✓ 로그인 완료"가 출력되면 다음 단계로 진행합니다.
 
-### 방법 B: Device Code (샌드박스/원격 환경)
-
-Cowork, 원격 서버 등 브라우저 콜백이 localhost에 도달할 수 없는 환경에서는 이 방법을 사용합니다.
+### 방법 2: Device Code (환경 B — 샌드박스)
 
 ```bash
-relay login --device
+npx relayax-cli login --device
 ```
 
 - 화면에 URL과 8자리 코드가 표시됩니다.
-- 브라우저가 자동으로 열립니다. 열리지 않으면 표시된 URL을 별도 명령어로 엽니다: `open <URL>` (macOS) / `xdg-open <URL>` (Linux)
-- 브라우저에서 코드를 입력하고 로그인을 승인합니다.
+- 표시된 URL을 브라우저에서 열고, 코드를 입력하고 로그인을 승인합니다.
 - CLI가 자동으로 승인을 감지하고 "✓ 로그인 완료"를 출력합니다.
-
-`relay whoami`로 로그인 성공을 확인한 후 다음 단계로 진행합니다.

package/dist/prompts/index.d.ts

@@ -1,5 +1,6 @@
 export declare const REQUIREMENTS_CHECK: string;
 export declare const ERROR_HANDLING_GUIDE: string;
+export declare const SETUP_ENVIRONMENT: string;
 export declare const SETUP_CLI: string;
 export declare const SETUP_LOGIN: string;
 export declare const INSTALL_PROMPT: string;

package/dist/prompts/index.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PUBLISH_PROMPT = exports.INSTALL_PROMPT = exports.SETUP_LOGIN = exports.SETUP_CLI = exports.ERROR_HANDLING_GUIDE = exports.REQUIREMENTS_CHECK = void 0;
+exports.PUBLISH_PROMPT = exports.INSTALL_PROMPT = exports.SETUP_LOGIN = exports.SETUP_CLI = exports.SETUP_ENVIRONMENT = exports.ERROR_HANDLING_GUIDE = exports.REQUIREMENTS_CHECK = void 0;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 function readPrompt(filename) {
@@ -15,6 +15,7 @@ function interpolate(template, vars) {
 // ─── 공유 조각 ───
 exports.REQUIREMENTS_CHECK = readPrompt('_requirements-check.md');
 exports.ERROR_HANDLING_GUIDE = readPrompt('_error-handling.md');
+exports.SETUP_ENVIRONMENT = readPrompt('_setup-environment.md');
 exports.SETUP_CLI = readPrompt('_setup-cli.md');
 exports.SETUP_LOGIN = readPrompt('_setup-login.md');
 const fragments = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "relayax-cli",
-  "version": "0.3.45",
+  "version": "0.3.48",
   "description": "RelayAX Agent Team Marketplace CLI - Install and manage agent teams",
   "main": "dist/index.js",
   "bin": {