relayax-cli 0.3.46 → 0.3.49

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/index.js

@@ -25,6 +25,7 @@ const access_js_1 = require("./commands/access.js");
 const grant_js_1 = require("./commands/grant.js");
 const versions_js_1 = require("./commands/versions.js");
 const diff_js_1 = require("./commands/diff.js");
+const server_js_1 = require("./mcp/server.js");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const pkg = require('../package.json');
 const program = new commander_1.Command();
@@ -56,4 +57,10 @@ program
 (0, grant_js_1.registerGrant)(program);
 (0, versions_js_1.registerVersions)(program);
 (0, diff_js_1.registerDiff)(program);
+program
+    .command('mcp')
+    .description('MCP 서버 모드로 실행합니다 (stdio transport)')
+    .action(async () => {
+    await (0, server_js_1.startMcpServer)();
+});
 program.parse();

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/mcp/server.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function createMcpServer(): McpServer;
+export declare function startMcpServer(): Promise<void>;

package/dist/mcp/server.js

@@ -0,0 +1,267 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMcpServer = createMcpServer;
+exports.startMcpServer = startMcpServer;
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const zod_1 = require("zod");
+const config_js_1 = require("../lib/config.js");
+const api_js_1 = require("../lib/api.js");
+const slug_js_1 = require("../lib/slug.js");
+const storage_js_1 = require("../lib/storage.js");
+const ai_tools_js_1 = require("../lib/ai-tools.js");
+const preamble_js_1 = require("../lib/preamble.js");
+const installer_js_1 = require("../lib/installer.js");
+const paths_js_1 = require("../lib/paths.js");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const js_yaml_1 = __importDefault(require("js-yaml"));
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const pkg = require('../../package.json');
+// ─── Helpers ───
+async function resolveUsername(token) {
+    try {
+        const res = await fetch(`${config_js_1.API_URL}/api/auth/me`, {
+            headers: { Authorization: `Bearer ${token}` },
+        });
+        if (!res.ok)
+            return undefined;
+        const body = await res.json();
+        return body.username;
+    }
+    catch {
+        return undefined;
+    }
+}
+function countFiles(dir) {
+    let count = 0;
+    if (!fs_1.default.existsSync(dir))
+        return 0;
+    for (const entry of fs_1.default.readdirSync(dir, { withFileTypes: true })) {
+        if (entry.isDirectory())
+            count += countFiles(path_1.default.join(dir, entry.name));
+        else
+            count++;
+    }
+    return count;
+}
+function jsonText(obj) {
+    return { type: 'text', text: JSON.stringify(obj) };
+}
+// ─── Server ───
+function createMcpServer() {
+    const server = new mcp_js_1.McpServer({ name: 'relay', version: pkg.version }, { capabilities: { tools: {}, prompts: {} } });
+    // ═══ Tools ═══
+    server.tool('relay_search', '에이전트를 검색합니다', {
+        query: zod_1.z.string().describe('검색 키워드'),
+        tag: zod_1.z.string().optional().describe('태그 필터'),
+    }, async ({ query, tag }) => {
+        try {
+            const results = await (0, api_js_1.searchAgents)(query, tag);
+            return { content: [jsonText({ results: results.map((r) => ({ slug: r.slug, name: r.name, description: r.description, installs: r.install_count })) })] };
+        }
+        catch (err) {
+            return { content: [jsonText({ error: String(err) })], isError: true };
+        }
+    });
+    server.tool('relay_install', '에이전트를 설치합니다', {
+        slug: zod_1.z.string().describe('에이전트 slug (예: @owner/name)'),
+        project_path: zod_1.z.string().optional().describe('프로젝트 경로 (기본: cwd)'),
+    }, async ({ slug: slugInput, project_path }) => {
+        try {
+            const projectPath = project_path ?? (0, paths_js_1.resolveProjectPath)();
+            const token = await (0, config_js_1.getValidToken)();
+            const parsed = await (0, slug_js_1.resolveSlug)(slugInput);
+            const fullSlug = parsed.full;
+            const agent = await (0, api_js_1.fetchAgentInfo)(fullSlug);
+            if (!agent)
+                throw new Error('에이전트 정보를 가져오지 못했습니다.');
+            if ((agent.visibility ?? 'public') !== 'public' && !token) {
+                return { content: [jsonText({ error: 'LOGIN_REQUIRED', message: '이 에이전트는 로그인이 필요합니다.' })], isError: true };
+            }
+            const tempDir = (0, storage_js_1.makeTempDir)();
+            try {
+                const tarPath = await (0, storage_js_1.downloadPackage)(agent.package_url, tempDir);
+                const agentDir = path_1.default.join(projectPath, '.relay', 'agents', parsed.owner, parsed.name);
+                if (fs_1.default.existsSync(agentDir))
+                    fs_1.default.rmSync(agentDir, { recursive: true, force: true });
+                fs_1.default.mkdirSync(agentDir, { recursive: true });
+                await (0, storage_js_1.extractPackage)(tarPath, agentDir);
+                (0, preamble_js_1.injectPreambleToAgent)(agentDir, fullSlug);
+                const installed = (0, config_js_1.loadInstalled)();
+                installed[fullSlug] = { agent_id: agent.id, version: agent.version, installed_at: new Date().toISOString(), files: [agentDir] };
+                (0, config_js_1.saveInstalled)(installed);
+                await (0, api_js_1.reportInstall)(agent.id, fullSlug, agent.version);
+                (0, api_js_1.sendUsagePing)(agent.id, fullSlug, agent.version);
+                return { content: [jsonText({ status: 'ok', agent: agent.name, slug: fullSlug, version: agent.version, files: countFiles(agentDir), install_path: agentDir })] };
+            }
+            finally {
+                (0, storage_js_1.removeTempDir)(tempDir);
+            }
+        }
+        catch (err) {
+            return { content: [jsonText({ error: String(err) })], isError: true };
+        }
+    });
+    server.tool('relay_uninstall', '에이전트를 제거합니다', {
+        slug: zod_1.z.string().describe('에이전트 slug'),
+    }, async ({ slug: slugInput }) => {
+        try {
+            const local = (0, config_js_1.loadInstalled)();
+            const global = (0, config_js_1.loadGlobalInstalled)();
+            const entry = local[slugInput] ?? global[slugInput];
+            if (!entry) {
+                return { content: [jsonText({ error: 'NOT_INSTALLED', message: `'${slugInput}'는 설치되어 있지 않습니다.` })], isError: true };
+            }
+            let removed = 0;
+            if (local[slugInput]) {
+                removed += (0, installer_js_1.uninstallAgent)(local[slugInput].files).length;
+                delete local[slugInput];
+                (0, config_js_1.saveInstalled)(local);
+            }
+            if (global[slugInput]) {
+                removed += (0, installer_js_1.uninstallAgent)(global[slugInput].files).length;
+                delete global[slugInput];
+                (0, config_js_1.saveGlobalInstalled)(global);
+            }
+            return { content: [jsonText({ status: 'ok', removed_files: removed })] };
+        }
+        catch (err) {
+            return { content: [jsonText({ error: String(err) })], isError: true };
+        }
+    });
+    server.tool('relay_list', '설치된 에이전트 목록을 조회합니다', {}, async () => {
+        const local = (0, config_js_1.loadInstalled)();
+        const global = (0, config_js_1.loadGlobalInstalled)();
+        const agents = [
+            ...Object.entries(local).map(([slug, e]) => ({ slug, version: e.version, installed_at: e.installed_at, scope: 'local' })),
+            ...Object.entries(global).map(([slug, e]) => ({ slug, version: e.version, installed_at: e.installed_at, scope: 'global' })),
+        ];
+        return { content: [jsonText({ agents })] };
+    });
+    server.tool('relay_status', '현재 relay 환경 상태를 표시합니다', {
+        project_path: zod_1.z.string().optional().describe('프로젝트 경로'),
+    }, async ({ project_path }) => {
+        const projectPath = project_path ?? (0, paths_js_1.resolveProjectPath)();
+        const token = await (0, config_js_1.getValidToken)();
+        let username;
+        if (token)
+            username = await resolveUsername(token);
+        const detected = (0, ai_tools_js_1.detectAgentCLIs)(projectPath);
+        const mounted = (0, ai_tools_js_1.detectMountedCLIs)();
+        const relayYaml = path_1.default.join(projectPath, '.relay', 'relay.yaml');
+        let project = null;
+        if (fs_1.default.existsSync(relayYaml)) {
+            try {
+                const cfg = js_yaml_1.default.load(fs_1.default.readFileSync(relayYaml, 'utf-8'));
+                project = { is_agent: true, name: cfg.name, slug: cfg.slug, version: cfg.version };
+            }
+            catch { /* skip */ }
+        }
+        return { content: [jsonText({ login: { authenticated: !!token, username }, agent_clis: detected.map((t) => t.name), mounted_paths: mounted.map((m) => m.basePath), project })] };
+    });
+    server.tool('relay_scan', '배포 가능한 스킬/에이전트/커맨드를 스캔합니다', {
+        project_path: zod_1.z.string().optional().describe('프로젝트 경로'),
+    }, async ({ project_path }) => {
+        const projectPath = project_path ?? (0, paths_js_1.resolveProjectPath)();
+        const homeDir = (0, paths_js_1.resolveHome)();
+        const sources = [];
+        // 로컬
+        for (const tool of (0, ai_tools_js_1.detectAgentCLIs)(projectPath)) {
+            const items = (0, ai_tools_js_1.scanLocalItems)(projectPath, tool);
+            if (items.length > 0)
+                sources.push({ path: tool.skillsDir, location: 'local', name: tool.name, items: items.map((i) => ({ name: i.name, type: i.type })) });
+        }
+        // 글로벌
+        const { detectGlobalCLIs } = await import('../lib/ai-tools.js');
+        for (const tool of detectGlobalCLIs(homeDir)) {
+            const items = (0, ai_tools_js_1.scanGlobalItems)(tool, homeDir);
+            if (items.length > 0)
+                sources.push({ path: `~/${tool.skillsDir}`, location: 'global', name: `${tool.name} (global)`, items: items.map((i) => ({ name: i.name, type: i.type })) });
+        }
+        // 마운트 (Cowork)
+        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: 'mounted', name: `${tool.name} (mounted)`, items: items.map((i) => ({ name: i.name, type: i.type })) });
+        }
+        return { content: [jsonText({ sources })] };
+    });
+    server.tool('relay_publish', '에이전트를 마켓플레이스에 배포합니다', {
+        project_path: zod_1.z.string().optional().describe('프로젝트 경로'),
+    }, async ({ project_path }) => {
+        const projectPath = project_path ?? (0, paths_js_1.resolveProjectPath)();
+        const relayYaml = path_1.default.join(projectPath, '.relay', 'relay.yaml');
+        if (!fs_1.default.existsSync(relayYaml)) {
+            return { content: [jsonText({ error: 'NOT_INITIALIZED', message: '.relay/relay.yaml이 없습니다. relay-publish 프롬프트를 사용하여 프로젝트를 먼저 설정하세요.' })], isError: true };
+        }
+        const token = await (0, config_js_1.getValidToken)();
+        if (!token) {
+            return { content: [jsonText({ error: 'LOGIN_REQUIRED', message: '배포하려면 로그인이 필요합니다.' })], isError: true };
+        }
+        const cfg = js_yaml_1.default.load(fs_1.default.readFileSync(relayYaml, 'utf-8'));
+        return { content: [jsonText({ status: 'ready', project_path: projectPath, name: cfg.name, slug: cfg.slug, version: cfg.version, message: '배포 준비 완료. relay-publish 프롬프트로 전체 워크플로우를 실행하세요.' })] };
+    });
+    // ═══ Prompts ═══
+    server.prompt('relay-install', '에이전트 검색 → 설치 가이드 워크플로우', {}, () => ({
+        messages: [{
+                role: 'user',
+                content: { type: 'text', text: `다음 가이드를 따라 에이전트를 설치하세요. relay MCP tool을 사용하여 각 단계를 실행합니다.
+
+사용 가능한 tool: relay_status, relay_search, relay_install, relay_list, relay_status
+
+## 워크플로우
+
+1. relay_status로 로그인 상태 확인. 미인증이면 사용자에게 터미널에서 \`npx relayax-cli login --device\` 실행을 안내.
+2. 사용자에게 어떤 에이전트를 찾는지 물어보기.
+3. relay_search로 검색.
+4. 검색 결과를 보여주고 선택하게 하기.
+5. relay_install로 설치.
+6. 설치 결과와 사용법 안내.` },
+            }],
+    }));
+    server.prompt('relay-publish', '에이전트 배포 가이드 워크플로우', {}, () => ({
+        messages: [{
+                role: 'user',
+                content: { type: 'text', text: `다음 가이드를 따라 에이전트를 배포하세요. relay MCP tool을 사용합니다.
+
+사용 가능한 tool: relay_status, relay_scan, relay_status, relay_publish
+
+## 워크플로우
+
+1. relay_status로 로그인 상태 확인. 미인증이면 터미널에서 \`npx relayax-cli login --device\` 안내.
+2. relay_scan으로 배포 가능한 스킬/에이전트/커맨드 목록 스캔.
+3. 스캔 결과를 보여주고 사용자에게 어떤 항목을 배포할지 선택하게 하기.
+4. relay_status로 프로젝트 상태 확인. .relay/relay.yaml이 없으면 프로젝트 생성 안내.
+5. relay_publish로 배포.
+6. 배포 결과를 사용자에게 보여주기.` },
+            }],
+    }));
+    server.prompt('relay-status', '환경 상태 확인', {}, () => ({
+        messages: [{
+                role: 'user',
+                content: { type: 'text', text: 'relay_status, relay_status, relay_list, relay_scan tool을 사용하여 현재 relay 환경 상태를 확인하고 사용자에게 보여주세요. 로그인 상태, 감지된 AI 도구, 프로젝트 정보, 설치된 에이전트, 배포 가능한 스킬 목록을 포함합니다.' },
+            }],
+    }));
+    server.prompt('relay-uninstall', '에이전트 제거 가이드', {}, () => ({
+        messages: [{
+                role: 'user',
+                content: { type: 'text', text: `다음 워크플로우를 따라 에이전트를 제거하세요:
+
+1. relay_list로 설치된 에이전트 목록 표시.
+2. 사용자에게 제거할 에이전트 선택하게 하기.
+3. relay_uninstall로 제거.
+4. 결과 보여주기.` },
+            }],
+    }));
+    return server;
+}
+// ─── Start ───
+async function startMcpServer() {
+    const server = createMcpServer();
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+}

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 status" | `relay status` | `npx relayax-cli status` |
+| "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,32 @@
 ## Step 2. 로그인
 
-먼저 `relay whoami`로 로그인 상태를 확인합니다. 이미 로그인되어 있으면 이 단계를 건너뛰세요.
+**중요: 로그인은 반드시 터미널(bash)에서 CLI 명령어로 수행합니다. 브라우저에서 직접 relayax.com에 접속하거나 웹 로그인 페이지를 여는 것은 올바른 방법이 아닙니다.**
 
-로그인이 필요하면 아래 두 방법 중 하나를 사용하세요.
+먼저 로그인 상태를 확인합니다. 이미 로그인되어 있으면 이 단계를 건너뛰세요.
 
-### 방법 A: 브라우저 콜백 (로컬 터미널)
+- 환경 A: `relay status`
+- 환경 B: `npx relayax-cli status`
 
-로컬 머신에서 직접 터미널을 사용하는 경우 이 방법을 사용합니다.
-`relay login`은 로컬 콜백 서버를 띄우고 브라우저 로그인 완료를 기다립니다.
-반드시 포그라운드에서 실행하고, timeout을 300초(5분) 이상으로 설정하세요.
+로그인이 필요하면 **반드시 아래 bash 명령어를 실행**하세요.
+
+### 환경 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에 도달할 수 없는 환경에서는 이 방법을 사용합니다.
+### 환경 B (샌드박스)
 
 ```bash
-relay login --device
+npx relayax-cli login --device
 ```
 
 - 화면에 URL과 8자리 코드가 표시됩니다.
-- 브라우저가 자동으로 열립니다. 열리지 않으면 표시된 URL을 별도 명령어로 엽니다: `open <URL>` (macOS) / `xdg-open <URL>` (Linux)
-- 브라우저에서 코드를 입력하고 로그인을 승인합니다.
+- 사용자에게 URL과 코드를 보여주세요. 사용자가 직접 브라우저에서 코드를 입력해야 합니다.
 - CLI가 자동으로 승인을 감지하고 "✓ 로그인 완료"를 출력합니다.
-
-`relay whoami`로 로그인 성공을 확인한 후 다음 단계로 진행합니다.
+- timeout이 짧으면 `--timeout 300`을 추가하세요.

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.49",
   "description": "RelayAX Agent Team Marketplace CLI - Install and manage agent teams",
   "main": "dist/index.js",
   "bin": {
@@ -34,6 +34,7 @@
   "homepage": "https://relayax.com",
   "dependencies": {
     "@inquirer/prompts": "^8.3.2",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "commander": "^13.1.0",
     "form-data": "^4.0.5",
     "js-yaml": "^4.1.1",