relayax-cli 0.3.44 → 0.3.46

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/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/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/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

@@ -1,3 +1,21 @@
+## Step 0. 환경 감지
+
+sandbox 환경(Cowork, Codex 등)에서는 `$HOME`이 격리될 수 있습니다.
+아래 명령어로 확인하세요:
+
+```bash
+ls ~/.relay/token 2>/dev/null && echo "token-ok" || echo "token-missing"
+```
+
+`token-missing`이면, 이 세션에서 `relay login --device`로 새로 로그인해야 합니다.
+이미 로그인한 토큰이 있다면 환경변수로 전달할 수도 있습니다:
+
+```bash
+export RELAY_TOKEN=<토큰>
+```
+
+`token-ok`이면 이 단계를 건너뛰세요.
+
 ## Step 1. Relay CLI 설치
 
 relay CLI가 설치되어 있지 않다면:

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.44",
+  "version": "0.3.46",
   "description": "RelayAX Agent Team Marketplace CLI - Install and manage agent teams",
   "main": "dist/index.js",
   "bin": {