relayax-cli 0.3.43 → 0.3.45

package/dist/commands/create.js

@@ -11,6 +11,7 @@ const ai_tools_js_1 = require("../lib/ai-tools.js");
 const command_adapter_js_1 = require("../lib/command-adapter.js");
 const init_js_1 = require("./init.js");
 const slug_js_1 = require("../lib/slug.js");
+const paths_js_1 = require("../lib/paths.js");
 const DEFAULT_DIRS = ['.relay/skills', '.relay/commands'];
 /**
  * 글로벌 User 커맨드가 없으면 설치한다.
@@ -29,9 +30,10 @@ function registerCreate(program) {
         .option('--slug <slug>', 'URL용 식별자 (영문 소문자, 숫자, 하이픈)')
         .option('--tags <tags>', '태그 (쉼표 구분)')
         .option('--visibility <visibility>', '공개 범위 (public, private, internal)')
+        .option('--project <dir>', '프로젝트 루트 경로 (기본: cwd, 환경변수: RELAY_PROJECT_PATH)')
         .action(async (name, opts) => {
         const json = program.opts().json ?? false;
-        const projectPath = process.cwd();
+        const projectPath = (0, paths_js_1.resolveProjectPath)(opts.project);
         const relayDir = path_1.default.join(projectPath, '.relay');
         const relayYamlPath = path_1.default.join(relayDir, 'relay.yaml');
         const isTTY = Boolean(process.stdin.isTTY) && !json;

package/dist/commands/init.js

@@ -9,6 +9,7 @@ exports.registerInit = registerInit;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const ai_tools_js_1 = require("../lib/ai-tools.js");
+const paths_js_1 = require("../lib/paths.js");
 const command_adapter_js_1 = require("../lib/command-adapter.js");
 const config_js_1 = require("../lib/config.js");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
@@ -122,11 +123,12 @@ function registerInit(program) {
         .option('--tools <tools>', '설치할 에이전트 CLI 지정 (쉼표 구분)')
         .option('--all', '감지된 모든 에이전트 CLI에 설치')
         .option('--auto', '대화형 프롬프트 없이 자동으로 모든 감지된 CLI에 설치')
+        .option('--project <dir>', '프로젝트 루트 경로 (기본: cwd, 환경변수: RELAY_PROJECT_PATH)')
         .action(async (opts) => {
         const json = program.opts().json ?? false;
         // auto mode: --auto flag, --all flag, or stdin is not a TTY (but NOT --json alone)
         const autoMode = opts.auto === true || opts.all === true || !process.stdin.isTTY;
-        const projectPath = process.cwd();
+        const projectPath = (0, paths_js_1.resolveProjectPath)(opts.project);
         const detected = (0, ai_tools_js_1.detectAgentCLIs)(projectPath);
         const detectedIds = new Set(detected.map((t) => t.value));
         const isBuilder = isAgentProject(projectPath);

package/dist/commands/install.js

@@ -10,17 +10,18 @@ const api_js_1 = require("../lib/api.js");
 const storage_js_1 = require("../lib/storage.js");
 const config_js_1 = require("../lib/config.js");
 const slug_js_1 = require("../lib/slug.js");
-const contact_format_js_1 = require("../lib/contact-format.js");
 const preamble_js_1 = require("../lib/preamble.js");
 const init_js_1 = require("./init.js");
+const paths_js_1 = require("../lib/paths.js");
 function registerInstall(program) {
     program
         .command('install <slug>')
         .description('에이전트 패키지를 .relay/agents/에 다운로드합니다')
         .option('--join-code <code>', '초대 코드 (Organization 에이전트 설치 시 자동 가입)')
+        .option('--project <dir>', '프로젝트 루트 경로 (기본: cwd, 환경변수: RELAY_PROJECT_PATH)')
         .action(async (slugInput, _opts) => {
         const json = program.opts().json ?? false;
-        const projectPath = process.cwd();
+        const projectPath = (0, paths_js_1.resolveProjectPath)(_opts.project);
         const tempDir = (0, storage_js_1.makeTempDir)();
         // Auto-init: 글로벌 커맨드가 없으면 자동 설치
         if (!(0, init_js_1.hasGlobalUserCommands)()) {
@@ -228,7 +229,6 @@ function registerInstall(program) {
             }
             else {
                 const authorUsername = resolvedAgent.author?.username;
-                const authorDisplayName = resolvedAgent.author?.display_name ?? authorUsername ?? '';
                 const authorSuffix = authorUsername ? `  \x1b[90mby @${authorUsername}\x1b[0m` : '';
                 console.log(`\n\x1b[32m✓ ${resolvedAgent.name} 다운로드 완료\x1b[0m  v${resolvedAgent.version}${authorSuffix}`);
                 console.log(`  위치: \x1b[36m${agentDir}\x1b[0m`);
@@ -239,23 +239,6 @@ function registerInstall(program) {
                         console.log(`    \x1b[33m/${cmd.name}\x1b[0m - ${cmd.description}`);
                     }
                 }
-                // Builder business card
-                const contactParts = (0, contact_format_js_1.formatContactParts)(resolvedAgent.author?.contact_links);
-                const hasCard = resolvedAgent.welcome || contactParts.length > 0 || authorUsername;
-                if (hasCard) {
-                    console.log(`\n  \x1b[90m┌─ ${authorDisplayName || authorUsername || '빌더'}의 명함 ${'─'.repeat(Math.max(0, 34 - (authorDisplayName || authorUsername || '빌더').length))}┐\x1b[0m`);
-                    if (resolvedAgent.welcome) {
-                        const truncated = resolvedAgent.welcome.length > 45 ? resolvedAgent.welcome.slice(0, 45) + '...' : resolvedAgent.welcome;
-                        console.log(`  \x1b[90m│\x1b[0m  💬 "${truncated}"`);
-                    }
-                    if (contactParts.length > 0) {
-                        console.log(`  \x1b[90m│\x1b[0m  📇 ${contactParts.join('  ')}`);
-                    }
-                    if (authorUsername) {
-                        console.log(`  \x1b[90m│\x1b[0m  👤 relayax.com/@${authorUsername}`);
-                    }
-                    console.log(`  \x1b[90m└${'─'.repeat(44)}┘\x1b[0m`);
-                }
                 // Usage hint (type-aware)
                 const agentType = resolvedAgent.type;
                 if (agentType === 'passive') {

package/dist/commands/login.js

@@ -119,6 +119,46 @@ async function loginWithBrowser(json) {
     }
     return waitForToken(port);
 }
+async function loginWithDevice(json) {
+    const res = await fetch(`${config_js_1.API_URL}/api/auth/device/request`, { method: 'POST' });
+    if (!res.ok) {
+        throw new Error('Device code 발급에 실패했습니다');
+    }
+    const { device_code, user_code, verification_url, expires_in } = await res.json();
+    if (json) {
+        console.error(JSON.stringify({ status: 'waiting', verification_url, user_code, expires_in }));
+    }
+    else {
+        console.error(`\n아래 URL에서 코드를 입력하세요:\n`);
+        console.error(`  ${verification_url}`);
+        console.error(`\n  코드: \x1b[1m${user_code}\x1b[0m\n`);
+    }
+    openBrowser(`${verification_url}?user_code=${user_code}`);
+    const deadline = Date.now() + expires_in * 1000;
+    while (Date.now() < deadline) {
+        await new Promise((r) => setTimeout(r, 5000));
+        const pollRes = await fetch(`${config_js_1.API_URL}/api/auth/device/poll`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ device_code }),
+        });
+        if (!pollRes.ok)
+            continue;
+        const data = await pollRes.json();
+        if (data.status === 'approved' && data.token) {
+            return {
+                token: data.token,
+                refresh_token: data.refresh_token,
+                expires_at: data.expires_at ? Number(data.expires_at) : undefined,
+            };
+        }
+        if (data.status === 'expired') {
+            throw new Error('코드가 만료되었습니다. 다시 시도하세요.');
+        }
+        // pending — continue polling
+    }
+    throw new Error('로그인 시간이 초과되었습니다 (5분)');
+}
 /**
  * 대화형 로그인 플로우 실행 (auto-login에서 호출).
  * 브라우저에서 로그인 페이지를 열고 토큰을 받아 저장.
@@ -139,6 +179,7 @@ function registerLogin(program) {
         .command('login')
         .description('RelayAX 계정에 로그인합니다')
         .option('--token <token>', '직접 토큰 입력 (브라우저 없이)')
+        .option('--device', 'Device code 방식으로 로그인 (샌드박스/원격 환경용)')
         .action(async (opts) => {
         const json = program.opts().json ?? false;
         (0, config_js_1.ensureGlobalRelayDir)();
@@ -146,8 +187,9 @@ function registerLogin(program) {
         let refreshToken;
         let expiresAt;
         if (!accessToken) {
+            const loginFn = opts.device ? loginWithDevice : loginWithBrowser;
             try {
-                const loginResult = await loginWithBrowser(json);
+                const loginResult = await loginFn(json);
                 accessToken = loginResult.token;
                 refreshToken = loginResult.refresh_token;
                 expiresAt = loginResult.expires_at;
@@ -155,10 +197,13 @@ function registerLogin(program) {
             catch (err) {
                 const msg = err instanceof Error ? err.message : '로그인 실패';
                 if (json) {
-                    console.error(JSON.stringify({ error: 'LOGIN_FAILED', message: msg, fix: '브라우저에서 로그인을 완료하고 relay login을 재시도하세요.' }));
+                    console.error(JSON.stringify({ error: 'LOGIN_FAILED', message: msg, fix: opts.device ? '다시 시도하세요.' : 'relay login --device를 시도하세요.' }));
                 }
                 else {
                     console.error(`\x1b[31m오류: ${msg}\x1b[0m`);
+                    if (!opts.device) {
+                        console.error(`\n\x1b[33m팁: 브라우저 콜백이 안 되는 환경이라면 relay login --device를 시도하세요.\x1b[0m`);
+                    }
                 }
                 process.exit(1);
             }

package/dist/commands/package.js

@@ -12,6 +12,7 @@ const path_1 = __importDefault(require("path"));
 const crypto_1 = __importDefault(require("crypto"));
 const js_yaml_1 = __importDefault(require("js-yaml"));
 const ai_tools_js_1 = require("../lib/ai-tools.js");
+const paths_js_1 = require("../lib/paths.js");
 const SYNC_DIRS = ['skills', 'commands', 'agents', 'rules'];
 // ─── Helpers ───
 function fileHash(filePath) {
@@ -261,16 +262,19 @@ function registerPackage(program) {
         .option('--sync', '변경사항을 .relay/에 즉시 반영', false)
         .option('--init', '최초 패키징: 소스 감지 → .relay/ 초기화', false)
         .option('--migrate', '기존 source 필드를 contents로 마이그레이션', false)
+        .option('--project <dir>', '프로젝트 루트 경로 (기본: cwd, 환경변수: RELAY_PROJECT_PATH)')
+        .option('--home <dir>', '홈 디렉토리 경로 (기본: os.homedir(), 환경변수: RELAY_HOME)')
         .action(async (opts) => {
         const json = program.opts().json ?? false;
-        const projectPath = process.cwd();
+        const projectPath = (0, paths_js_1.resolveProjectPath)(opts.project);
+        const homeDir = (0, paths_js_1.resolveHome)(opts.home);
         const relayDir = path_1.default.join(projectPath, '.relay');
         const relayYamlPath = path_1.default.join(relayDir, 'relay.yaml');
         // ─── 최초 패키징 (--init) ───
         if (opts.init || !fs_1.default.existsSync(relayYamlPath)) {
             // 로컬 + 글로벌 소스를 모두 스캔하여 개별 항목 목록 생성
             const localTools = (0, ai_tools_js_1.detectAgentCLIs)(projectPath);
-            const globalTools = (0, ai_tools_js_1.detectGlobalCLIs)();
+            const globalTools = (0, ai_tools_js_1.detectGlobalCLIs)(homeDir);
             const sources = [];
             for (const tool of localTools) {
                 const items = (0, ai_tools_js_1.scanLocalItems)(projectPath, tool);
@@ -284,7 +288,7 @@ function registerPackage(program) {
                 }
             }
             for (const tool of globalTools) {
-                const items = (0, ai_tools_js_1.scanGlobalItems)(tool);
+                const items = (0, ai_tools_js_1.scanGlobalItems)(tool, homeDir);
                 if (items.length > 0) {
                     sources.push({
                         path: `~/${tool.skillsDir}`,
@@ -295,7 +299,7 @@ function registerPackage(program) {
                 }
             }
             // ~/.relay/agents/ 에 기존 에이전트 패키지가 있는지 스캔
-            const globalAgentsDir = path_1.default.join(os_1.default.homedir(), '.relay', 'agents');
+            const globalAgentsDir = path_1.default.join(homeDir ?? os_1.default.homedir(), '.relay', 'agents');
             const existingAgents = [];
             if (fs_1.default.existsSync(globalAgentsDir)) {
                 for (const entry of fs_1.default.readdirSync(globalAgentsDir, { withFileTypes: true })) {

package/dist/commands/publish.js

@@ -10,9 +10,9 @@ const os_1 = __importDefault(require("os"));
 const js_yaml_1 = __importDefault(require("js-yaml"));
 const tar_1 = require("tar");
 const config_js_1 = require("../lib/config.js");
-const contact_format_js_1 = require("../lib/contact-format.js");
 const preamble_js_1 = require("../lib/preamble.js");
 const version_check_js_1 = require("../lib/version-check.js");
+const paths_js_1 = require("../lib/paths.js");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const cliPkg = require('../../package.json');
 const VALID_DIRS = ['skills', 'agents', 'rules', 'commands', 'bin'];
@@ -285,9 +285,10 @@ function registerPublish(program) {
         .option('--token <token>', '인증 토큰')
         .option('--space <slug>', '배포할 Space 지정')
         .option('--version <version>', '배포 버전 지정 (relay.yaml 업데이트)')
+        .option('--project <dir>', '프로젝트 루트 경로 (기본: cwd, 환경변수: RELAY_PROJECT_PATH)')
         .action(async (opts) => {
         const json = program.opts().json ?? false;
-        const agentDir = process.cwd();
+        const agentDir = (0, paths_js_1.resolveProjectPath)(opts.project);
         const relayDir = path_1.default.join(agentDir, '.relay');
         const relayYamlPath = path_1.default.join(relayDir, 'relay.yaml');
         const isTTY = Boolean(process.stdin.isTTY) && !json;
@@ -355,7 +356,6 @@ function registerPublish(program) {
                     { name: '비공개 — Org 멤버만', value: 'internal' },
                 ],
             });
-            console.error('\n\x1b[2m💡 프로필에 연락처를 설정하면 설치 시 명함이 전달됩니다: www.relayax.com/dashboard/profile\x1b[0m');
             if (visibility === 'private') {
                 console.error('\x1b[2m💡 링크 공유 에이전트는 웹 대시보드에서 접근 링크와 구매 안내를 설정하세요: www.relayax.com/dashboard\x1b[0m');
             }
@@ -601,10 +601,6 @@ function registerPublish(program) {
                 console.error(`  → relay.yaml에 visibility: ${config.visibility} 저장됨 (${visLabelMap[config.visibility]})\n`);
             }
         }
-        // Profile hint
-        if (isTTY) {
-            console.error('💡 프로필에 연락처를 설정하면 설치 시 명함이 전달됩니다: www.relayax.com/dashboard/profile');
-        }
         const detectedCommands = detectCommands(relayDir);
         const components = {
             agents: countDir(relayDir, 'agents'),
@@ -687,27 +683,6 @@ function registerPublish(program) {
                 console.log(`\n\x1b[32m✓ ${config.name} 배포 완료\x1b[0m  v${result.version}`);
                 console.log(`  슬러그: \x1b[36m${result.slug}\x1b[0m`);
                 console.log(`  URL:    \x1b[36m${result.url}\x1b[0m`);
-                // Show business card preview
-                const profile = result.profile;
-                if (profile) {
-                    const contactParts = (0, contact_format_js_1.formatContactParts)(profile.contact_links);
-                    const welcome = profile.default_welcome ?? '';
-                    console.log(`\n  \x1b[90m┌─ 설치자에게 보이는 명함 ${'─'.repeat(24)}┐\x1b[0m`);
-                    if (welcome) {
-                        console.log(`  \x1b[90m│\x1b[0m  💬 "${welcome.length > 45 ? welcome.slice(0, 45) + '...' : welcome}"`);
-                    }
-                    if (contactParts.length > 0) {
-                        console.log(`  \x1b[90m│\x1b[0m  📇 ${contactParts.join('  ')}`);
-                    }
-                    if (profile.username) {
-                        console.log(`  \x1b[90m│\x1b[0m  👤 relayax.com/@${profile.username}`);
-                    }
-                    if (!welcome && contactParts.length === 0) {
-                        console.log(`  \x1b[90m│\x1b[0m  \x1b[2m명함이 비어있습니다\x1b[0m`);
-                    }
-                    console.log(`  \x1b[90m└${'─'.repeat(44)}┘\x1b[0m`);
-                    console.log(`\n  \x1b[90m명함 수정: \x1b[36mwww.relayax.com/dashboard/profile\x1b[0m`);
-                }
                 // Show shareable onboarding guide as a plain copyable block
                 if (isTTY) {
                     const detailSlug = result.slug.startsWith('@') ? result.slug.slice(1) : result.slug;

package/dist/commands/status.js

@@ -7,6 +7,7 @@ exports.registerStatus = registerStatus;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const ai_tools_js_1 = require("../lib/ai-tools.js");
+const paths_js_1 = require("../lib/paths.js");
 const config_js_1 = require("../lib/config.js");
 const command_adapter_js_1 = require("../lib/command-adapter.js");
 async function resolveUsername(token) {
@@ -27,9 +28,10 @@ function registerStatus(program) {
     program
         .command('status')
         .description('현재 relay 환경 상태를 표시합니다')
-        .action(async () => {
+        .option('--project <dir>', '프로젝트 루트 경로 (기본: cwd, 환경변수: RELAY_PROJECT_PATH)')
+        .action(async (opts) => {
         const json = program.opts().json ?? false;
-        const projectPath = process.cwd();
+        const projectPath = (0, paths_js_1.resolveProjectPath)(opts.project);
         // 1. 로그인 상태
         const token = await (0, config_js_1.getValidToken)();
         let username;

package/dist/commands/uninstall.js

@@ -10,6 +10,7 @@ const config_js_1 = require("../lib/config.js");
 const installer_js_1 = require("../lib/installer.js");
 const slug_js_1 = require("../lib/slug.js");
 const ai_tools_js_1 = require("../lib/ai-tools.js");
+const paths_js_1 = require("../lib/paths.js");
 /**
  * deployed_files에서 에이전트 설정 디렉토리(skillsDir) 기반 boundary를 추론한다.
  * 예: deployed_files에 '~/.cursor/commands/relay/x.md'가 있으면 boundary는 basePath/.cursor
@@ -31,7 +32,8 @@ function registerUninstall(program) {
     program
         .command('uninstall <slug>')
         .description('에이전트 제거')
-        .action((slugInput) => {
+        .option('--project <dir>', '프로젝트 루트 경로 (기본: cwd, 환경변수: RELAY_PROJECT_PATH)')
+        .action((slugInput, _opts) => {
         const json = program.opts().json ?? false;
         const localInstalled = (0, config_js_1.loadInstalled)();
         const globalInstalled = (0, config_js_1.loadGlobalInstalled)();
@@ -70,7 +72,7 @@ function registerUninstall(program) {
                 const deployedRemoved = (0, installer_js_1.uninstallAgent)(localEntry.deployed_files);
                 totalRemoved += deployedRemoved.length;
                 // Clean empty parent directories
-                const boundary = inferBoundary(localEntry.deployed_files, process.cwd());
+                const boundary = inferBoundary(localEntry.deployed_files, (0, paths_js_1.resolveProjectPath)(_opts.project));
                 for (const f of deployedRemoved) {
                     (0, installer_js_1.cleanEmptyParents)(f, boundary);
                 }

package/dist/commands/update.js

@@ -6,7 +6,6 @@ const storage_js_1 = require("../lib/storage.js");
 const installer_js_1 = require("../lib/installer.js");
 const config_js_1 = require("../lib/config.js");
 const slug_js_1 = require("../lib/slug.js");
-const contact_format_js_1 = require("../lib/contact-format.js");
 const preamble_js_1 = require("../lib/preamble.js");
 function registerUpdate(program) {
     program
@@ -95,11 +94,6 @@ function registerUpdate(program) {
                 console.log(`\n\x1b[32m✓ ${agent.name} ${fromLabel}v${latestVersion} 업데이트 완료\x1b[0m`);
                 console.log(`  설치 위치: \x1b[36m${installPath}\x1b[0m`);
                 console.log(`  파일 수:   ${files.length}개`);
-                // Builder business card
-                const authorUsername = agent.author?.username;
-                const authorDisplayName = agent.author?.display_name ?? authorUsername ?? '';
-                const contactParts = (0, contact_format_js_1.formatContactParts)(agent.author?.contact_links);
-                const hasCard = agent.welcome || contactParts.length > 0 || authorUsername;
                 // Show changelog for this version
                 try {
                     const versions = await (0, api_js_1.fetchAgentVersions)(slug);
@@ -115,20 +109,6 @@ function registerUpdate(program) {
                 catch {
                     // Non-critical: skip changelog display
                 }
-                if (hasCard) {
-                    console.log(`\n  \x1b[90m┌─ ${authorDisplayName || '빌더'}의 명함 ${'─'.repeat(Math.max(0, 34 - (authorDisplayName || '빌더').length))}┐\x1b[0m`);
-                    if (agent.welcome) {
-                        const truncated = agent.welcome.length > 45 ? agent.welcome.slice(0, 45) + '...' : agent.welcome;
-                        console.log(`  \x1b[90m│\x1b[0m  💬 "${truncated}"`);
-                    }
-                    if (contactParts.length > 0) {
-                        console.log(`  \x1b[90m│\x1b[0m  📇 ${contactParts.join('  ')}`);
-                    }
-                    if (authorUsername) {
-                        console.log(`  \x1b[90m│\x1b[0m  👤 relayax.com/@${authorUsername}`);
-                    }
-                    console.log(`  \x1b[90m└${'─'.repeat(44)}┘\x1b[0m`);
-                }
             }
         }
         catch (err) {

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

@@ -16,7 +16,7 @@ export declare function detectAgentCLIs(projectPath: string): AITool[];
  * 홈 디렉토리에서 글로벌 에이전트 CLI 디렉토리를 감지한다.
  * ~/{skillsDir}/ 가 존재하는 CLI를 반환.
  */
-export declare function detectGlobalCLIs(): AITool[];
+export declare function detectGlobalCLIs(home?: string): AITool[];
 export type ContentType = 'skill' | 'agent' | 'command' | 'rule';
 export interface ContentItem {
     name: string;
@@ -31,4 +31,4 @@ export declare function scanLocalItems(projectPath: string, tool: AITool): Conte
 /**
  * 글로벌 홈 디렉토리 소스의 개별 스킬/에이전트/커맨드/룰 항목을 반환한다.
  */
-export declare function scanGlobalItems(tool: AITool): ContentItem[];
+export declare function scanGlobalItems(tool: AITool, home?: string): ContentItem[];

package/dist/lib/ai-tools.js

@@ -51,9 +51,9 @@ function detectAgentCLIs(projectPath) {
  * 홈 디렉토리에서 글로벌 에이전트 CLI 디렉토리를 감지한다.
  * ~/{skillsDir}/ 가 존재하는 CLI를 반환.
  */
-function detectGlobalCLIs() {
-    const home = os_1.default.homedir();
-    return exports.AI_TOOLS.filter((tool) => fs_1.default.existsSync(path_1.default.join(home, tool.skillsDir)));
+function detectGlobalCLIs(home) {
+    const homeDir = home ?? os_1.default.homedir();
+    return exports.AI_TOOLS.filter((tool) => fs_1.default.existsSync(path_1.default.join(homeDir, tool.skillsDir)));
 }
 const CONTENT_DIRS = [
     { dir: 'skills', type: 'skill' },
@@ -96,7 +96,7 @@ function scanLocalItems(projectPath, tool) {
 /**
  * 글로벌 홈 디렉토리 소스의 개별 스킬/에이전트/커맨드/룰 항목을 반환한다.
  */
-function scanGlobalItems(tool) {
-    const basePath = path_1.default.join(os_1.default.homedir(), tool.skillsDir);
+function scanGlobalItems(tool, home) {
+    const basePath = path_1.default.join(home ?? os_1.default.homedir(), tool.skillsDir);
     return scanItemsIn(basePath);
 }

package/dist/lib/command-adapter.js

@@ -60,7 +60,7 @@ function formatCommandFile(content) {
     return `---\ndescription: ${content.description}\n---\n\n${content.body}\n`;
 }
 // ─── 프롬프트 조각은 cli/src/prompts/*.md에서 관리 (SSOT) ───
-// REQUIREMENTS_CHECK, ERROR_HANDLING_GUIDE, BUSINESS_CARD_FORMAT → import from '../prompts/index.js'
+// REQUIREMENTS_CHECK, ERROR_HANDLING_GUIDE → import from '../prompts/index.js'
 // ─── User Commands (글로벌 설치) ───
 exports.USER_COMMANDS = [
     {

package/dist/lib/guide.js

@@ -79,8 +79,11 @@ ${commands.map((cmd) => `- \`/${cmd.name}\`: ${cmd.description}`).join('\n')}
 
 > ${config.description}
 
-이 가이드는 [RelayAX](https://relayax.com)에서 자동 생성되었습니다.
-아래 단계를 순서대로 실행하면 에이전트가 설치됩니다.
+이 가이드는 Relay 에이전트를 설치하는 절차입니다.
+각 Step의 명령어를 순서대로 실행하세요. 요약하지 말고 바로 Step 1부터 시작하세요.
+
+터미널(bash)을 실행할 수 없는 환경이라면, 아래 도구에서 이 URL을 열고 실행하세요:
+Claude Code · Claude Cowork · Codex · Cursor · Antigravity
 
 ${setupSection}
 

package/dist/lib/paths.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 프로젝트 루트 경로를 결정한다.
+ * 우선순위: --project 옵션 > RELAY_PROJECT_PATH 환경변수 > process.cwd()
+ */
+export declare function resolveProjectPath(optProject?: string): string;
+/**
+ * 홈 디렉토리 경로를 결정한다.
+ * 우선순위: --home 옵션 > RELAY_HOME 환경변수 > os.homedir()
+ */
+export declare function resolveHome(optHome?: string): string;

package/dist/lib/paths.js

@@ -0,0 +1,22 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveProjectPath = resolveProjectPath;
+exports.resolveHome = resolveHome;
+const os_1 = __importDefault(require("os"));
+/**
+ * 프로젝트 루트 경로를 결정한다.
+ * 우선순위: --project 옵션 > RELAY_PROJECT_PATH 환경변수 > process.cwd()
+ */
+function resolveProjectPath(optProject) {
+    return optProject ?? process.env.RELAY_PROJECT_PATH ?? process.cwd();
+}
+/**
+ * 홈 디렉토리 경로를 결정한다.
+ * 우선순위: --home 옵션 > RELAY_HOME 환경변수 > os.homedir()
+ */
+function resolveHome(optHome) {
+    return optHome ?? process.env.RELAY_HOME ?? os_1.default.homedir();
+}

package/dist/prompts/_setup-cli.md

@@ -17,3 +17,10 @@ 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
 ```
+
+이미 설치되어 있다면 최신 버전으로 업데이트하고 init을 재실행합니다:
+
+```bash
+npm update -g relayax-cli
+relay init
+```

package/dist/prompts/_setup-login.md

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

package/dist/prompts/_setup-org.md

@@ -1,5 +1,3 @@
-## Organization 생성
-
 먼저 Organization이 있는지 확인합니다:
 
 ```bash

package/dist/prompts/index.d.ts

@@ -1,6 +1,5 @@
 export declare const REQUIREMENTS_CHECK: string;
 export declare const ERROR_HANDLING_GUIDE: string;
-export declare const BUSINESS_CARD_FORMAT: 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.BUSINESS_CARD_FORMAT = exports.ERROR_HANDLING_GUIDE = exports.REQUIREMENTS_CHECK = void 0;
+exports.PUBLISH_PROMPT = exports.INSTALL_PROMPT = exports.SETUP_LOGIN = exports.SETUP_CLI = 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,13 +15,11 @@ function interpolate(template, vars) {
 // ─── 공유 조각 ───
 exports.REQUIREMENTS_CHECK = readPrompt('_requirements-check.md');
 exports.ERROR_HANDLING_GUIDE = readPrompt('_error-handling.md');
-exports.BUSINESS_CARD_FORMAT = readPrompt('_business-card.md');
 exports.SETUP_CLI = readPrompt('_setup-cli.md');
 exports.SETUP_LOGIN = readPrompt('_setup-login.md');
 const fragments = {
     REQUIREMENTS_CHECK: exports.REQUIREMENTS_CHECK,
     ERROR_HANDLING_GUIDE: exports.ERROR_HANDLING_GUIDE,
-    BUSINESS_CARD_FORMAT: exports.BUSINESS_CARD_FORMAT,
 };
 // ─── 전체 프롬프트 (조각 합성 완료) ───
 exports.INSTALL_PROMPT = interpolate(readPrompt('install.md'), fragments);

package/dist/prompts/install.md

@@ -132,10 +132,8 @@ relay deploy-record <slug> --scope <global|local> --files <배치된_파일1> <
 
 #### 3-1. 완료 안내
 - 배치된 파일과 활성화된 커맨드 목록을 보여줍니다.
-{{BUSINESS_CARD_FORMAT}}
-
 #### 3-2. 팔로우 제안 (필수 — 이 단계를 절대 건너뛰지 마세요)
-명함 표시 직후, 빌더의 username이 JSON 결과에 있으면 **반드시** 사용자 질문 도구를 호출하세요.
+빌더의 username이 JSON 결과에 있으면 **반드시** 사용자 질문 도구를 호출하세요.
 
 **사용자 질문 도구 호출:**
 - question: `@{username}을 팔로우할까요? 새 버전 알림을 받을 수 있습니다.`
@@ -178,7 +176,6 @@ https://relayax.com/api/registry/{owner}/{slug}/guide.md
 → 사용자 질문 도구: "어디에 설치할까요?" → ["글로벌 (모든 프로젝트)", "로컬 (이 프로젝트만)"]
 → "글로벌" 선택
 → 설치 + 배치 + deploy-record
-→ 명함 표시
 → 사용자 질문 도구: "@alice을 팔로우할까요?" → ["팔로우", "건너뛰기"]
 → "✓ 설치 완료! /write-doc를 사용해볼까요?"
 
@@ -186,6 +183,5 @@ https://relayax.com/api/registry/{owner}/{slug}/guide.md
 → relay install @alice/doc-writer --json 실행 (Step 1 건너뜀)
 → 사용자 질문 도구: "어디에 설치할까요?" → ["글로벌 (모든 프로젝트)", "로컬 (이 프로젝트만)"]
 → 설치 + 배치 + deploy-record
-→ 명함 표시
 → 사용자 질문 도구: "@alice을 팔로우할까요?" → ["팔로우", "건너뛰기"]
 → "✓ 설치 완료! /write-doc를 사용해볼까요?"

package/dist/prompts/publish.md

@@ -429,7 +429,6 @@ https://relayax.com/api/registry/{owner}/{slug}/guide.md
 - `{owner}`과 `{slug}`는 배포된 에이전트의 실제 슬러그에서 추출합니다 (`@owner/slug` → `owner`, `slug`).
 - "이 블록을 동료에게 공유하면 AI 에이전트가 환경 체크부터 설치까지 자동으로 해줍니다"라고 안내합니다.
 - CLI가 이미 설치된 사용자를 위한 짧은 버전도 함께 표시: `/relay:relay-install <slug>`
-{{BUSINESS_CARD_FORMAT}}
 
 ## 예시
 

package/package.json

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