relayax-cli 0.3.46 → 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/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,27 +1,17 @@
-## Step 0. 환경 감지
+## Step 1. Relay CLI 준비
 
-sandbox 환경(Cowork, Codex 등)에서는 `$HOME`이 격리될 수 있습니다.
-아래 명령어로 확인하세요:
+### 환경 A (터미널)
 
 ```bash
-ls ~/.relay/token 2>/dev/null && echo "token-ok" || echo "token-missing"
-```
-
-`token-missing`이면, 이 세션에서 `relay login --device`로 새로 로그인해야 합니다.
-이미 로그인한 토큰이 있다면 환경변수로 전달할 수도 있습니다:
-
-```bash
-export RELAY_TOKEN=<토큰>
+npm install -g relayax-cli
+relay init
 ```
 
-`token-ok`이면 이 단계를 건너뛰세요.
-
-## Step 1. Relay CLI 설치
-
-relay CLI가 설치되어 있지 않다면:
+이미 설치되어 있다면 최신 버전으로 업데이트합니다:
 
 ```bash
-npm install -g relayax-cli
+npm update -g relayax-cli
+relay init
 ```
 
 Node.js가 없는 경우:
@@ -29,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.46",
+  "version": "0.3.48",
   "description": "RelayAX Agent Team Marketplace CLI - Install and manage agent teams",
   "main": "dist/index.js",
   "bin": {