relayax-cli 0.2.20 → 0.2.23

package/dist/commands/create.js

@@ -64,9 +64,8 @@ function registerCreate(program) {
             visibility = await promptSelect({
                 message: '공개 범위:',
                 choices: [
-                    { name: '전체 공개', value: 'public' },
-                    { name: '로그인 사용자만', value: 'login-only' },
-                    { name: '초대 코드 필요', value: 'invite-only' },
+                    { name: '공개', value: 'public' },
+                    { name: '비공개 (Space 멤버만)', value: 'private' },
                 ],
             });
         }

package/dist/commands/init.d.ts

@@ -1,2 +1,6 @@
 import { Command } from 'commander';
+/**
+ * 글로벌 User 커맨드가 이미 설치되어 있는지 확인한다.
+ */
+export declare function hasGlobalUserCommands(): boolean;
 export declare function registerInit(program: Command): void;

package/dist/commands/init.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasGlobalUserCommands = hasGlobalUserCommands;
 exports.registerInit = registerInit;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
@@ -115,8 +116,11 @@ function registerInit(program) {
         .description('에이전트 CLI에 relay 슬래시 커맨드를 설치합니다')
         .option('--tools <tools>', '설치할 에이전트 CLI 지정 (all 또는 쉼표 구분)')
         .option('--update', '이미 설치된 슬래시 커맨드를 최신 버전으로 업데이트')
+        .option('--auto', '대화형 프롬프트 없이 자동으로 모든 감지된 CLI에 설치')
         .action(async (opts) => {
         const json = program.opts().json ?? false;
+        // auto mode: --auto flag, --json flag, or stdin is not a TTY
+        const autoMode = opts.auto === true || json || !process.stdin.isTTY;
         const projectPath = process.cwd();
         const detected = (0, ai_tools_js_1.detectAgentCLIs)(projectPath);
         const detectedIds = new Set(detected.map((t) => t.value));
@@ -154,7 +158,8 @@ function registerInit(program) {
             else if (opts.tools) {
                 targetToolIds = resolveTools(opts.tools);
             }
-            else if (!json && process.stdin.isTTY) {
+            else if (!autoMode) {
+                // interactive mode: only when stdin is a TTY and not --auto/--json
                 showWelcome();
                 if (detected.length > 0) {
                     console.log(`  감지된 에이전트 CLI: \x1b[36m${detected.map((t) => t.name).join(', ')}\x1b[0m\n`);
@@ -171,18 +176,12 @@ function registerInit(program) {
                 }
             }
             else {
-                if (detected.length === 0) {
-                    if (json) {
-                        console.error(JSON.stringify({
-                            error: 'NO_AGENT_CLI',
-                            message: '에이전트 CLI 디렉토리를 찾을 수 없습니다. --tools 옵션으로 지정하세요.',
-                        }));
-                    }
-                    // 글로벌은 설치했으므로 에러로 종료하지 않음
-                    targetToolIds = [];
+                // auto mode: use detected CLIs, or all available tools if none detected
+                if (detected.length > 0) {
+                    targetToolIds = detected.map((t) => t.value);
                 }
                 else {
-                    targetToolIds = detected.map((t) => t.value);
+                    targetToolIds = ai_tools_js_1.AI_TOOLS.map((t) => t.value);
                 }
             }
             // Builder 커맨드 설치 (기존 파일 중 현재 목록에 없는 것 제거)
@@ -213,7 +212,7 @@ function registerInit(program) {
                 localResults.push({ tool: tool.name, commands: installedCommands });
             }
         }
-        else if (!json && process.stdin.isTTY) {
+        else if (!autoMode) {
             // User 모드: 글로벌만 설치, 안내 표시
             showWelcome();
         }

package/dist/commands/install.js

@@ -12,35 +12,138 @@ 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 join_js_1 = require("./join.js");
+const init_js_1 = require("./init.js");
+/**
+ * slugInput이 "@spaces/{spaceSlug}/{teamSlug}" 형식이면 파싱해 반환.
+ * 아니면 null.
+ */
+function parseSpaceTarget(slugInput) {
+    const m = slugInput.match(/^@spaces\/([a-z0-9][a-z0-9-]*)\/([a-z0-9][a-z0-9-]*)$/);
+    if (!m)
+        return null;
+    return {
+        spaceSlug: m[1],
+        rawTeamSlug: m[2],
+        teamSlug: `@${m[1]}/${m[2]}`,
+    };
+}
 function registerInstall(program) {
     program
         .command('install <slug>')
         .description('에이전트 팀 패키지를 .relay/teams/에 다운로드합니다')
         .option('--no-guide', 'GUIDE.html 브라우저 자동 오픈을 비활성화합니다')
+        .option('--join-code <code>', 'Space 초대 코드 (Space 팀 설치 시 자동 가입)')
         .action(async (slugInput, opts) => {
         const json = program.opts().json ?? false;
         const projectPath = process.cwd();
         const tempDir = (0, storage_js_1.makeTempDir)();
+        if (!(0, init_js_1.hasGlobalUserCommands)()) {
+            if (!json) {
+                console.error('\x1b[33m⚠ relay init이 실행되지 않았습니다. 먼저 relay init을 실행하세요.\x1b[0m');
+            }
+            else {
+                console.error(JSON.stringify({ error: 'NOT_INITIALIZED', message: 'relay init을 먼저 실행하세요.' }));
+            }
+            process.exit(1);
+        }
         try {
-            // 0. Resolve scoped slug
-            const parsed = await (0, slug_js_1.resolveSlug)(slugInput);
-            const slug = parsed.full;
-            // 1. Fetch team metadata
-            const team = await (0, api_js_1.fetchTeamInfo)(slug);
+            // 0. @spaces/{spaceSlug}/{teamSlug} 형식 감지 및 파싱
+            const spaceTarget = parseSpaceTarget(slugInput);
+            // 0a. --join-code가 있으면 먼저 Space 가입 시도
+            if (opts.joinCode && spaceTarget) {
+                try {
+                    const { spaceName } = await (0, join_js_1.joinSpace)(spaceTarget.spaceSlug, opts.joinCode);
+                    if (!json) {
+                        console.log(`\x1b[32m✅ ${spaceName} Space에 가입했습니다\x1b[0m`);
+                    }
+                }
+                catch (joinErr) {
+                    const joinMsg = joinErr instanceof Error ? joinErr.message : String(joinErr);
+                    // 이미 멤버인 경우 설치 계속 진행
+                    if (joinMsg !== 'ALREADY_MEMBER') {
+                        if (!json) {
+                            console.error(`\x1b[33m경고: Space 가입 실패 — ${joinMsg}\x1b[0m`);
+                        }
+                    }
+                }
+            }
+            // 0b. Resolve scoped slug and fetch team metadata
+            let team;
+            let slug;
+            let parsed;
+            if (spaceTarget) {
+                // Space 팀: POST /api/spaces/{spaceSlug}/teams/{teamSlug}/install
+                // This verifies membership, increments install count, and returns metadata.
+                try {
+                    team = await (0, api_js_1.installSpaceTeam)(spaceTarget.spaceSlug, spaceTarget.rawTeamSlug);
+                }
+                catch (fetchErr) {
+                    const fetchMsg = fetchErr instanceof Error ? fetchErr.message : String(fetchErr);
+                    if (fetchMsg.includes('403')) {
+                        if (json) {
+                            console.error(JSON.stringify({
+                                error: 'SPACE_ONLY',
+                                message: '이 팀은 Space 멤버만 설치 가능합니다.',
+                                spaceSlug: spaceTarget.spaceSlug,
+                            }));
+                        }
+                        else {
+                            console.error('\x1b[31m이 팀은 Space 멤버만 설치 가능합니다.\x1b[0m');
+                            console.error(`\x1b[33mSpace 관리자에게 초대 코드를 요청하세요: relay join ${spaceTarget.spaceSlug} --code <코드>\x1b[0m`);
+                        }
+                        process.exit(1);
+                    }
+                    throw fetchErr;
+                }
+                // slug from server is "@spaces/{spaceSlug}/{teamSlug}" — derive local path parts
+                parsed = { owner: spaceTarget.spaceSlug, name: spaceTarget.rawTeamSlug, full: team.slug };
+                slug = team.slug;
+            }
+            else {
+                // Normal registry install
+                const resolveInput = slugInput;
+                parsed = await (0, slug_js_1.resolveSlug)(resolveInput);
+                slug = parsed.full;
+                try {
+                    team = await (0, api_js_1.fetchTeamInfo)(slug);
+                }
+                catch (fetchErr) {
+                    const fetchMsg = fetchErr instanceof Error ? fetchErr.message : String(fetchErr);
+                    if (fetchMsg.includes('403')) {
+                        if (json) {
+                            console.error(JSON.stringify({
+                                error: 'SPACE_ONLY',
+                                message: '이 팀은 Space 멤버만 설치 가능합니다.',
+                                slug,
+                            }));
+                        }
+                        else {
+                            console.error('\x1b[31m이 팀은 Space 멤버만 설치 가능합니다.\x1b[0m');
+                            console.error('\x1b[33mSpace 관리자에게 초대 코드를 요청하세요.\x1b[0m');
+                        }
+                        process.exit(1);
+                    }
+                    throw fetchErr;
+                }
+            }
             const teamDir = path_1.default.join(projectPath, '.relay', 'teams', parsed.owner, parsed.name);
             // 2. Visibility check
             const visibility = team.visibility ?? 'public';
-            if (visibility === 'login-only' || visibility === 'invite-only') {
+            if (visibility === 'private') {
                 const token = await (0, config_js_1.getValidToken)();
                 if (!token) {
-                    console.error(JSON.stringify({
-                        error: 'LOGIN_REQUIRED',
-                        visibility,
-                        slug,
-                        message: visibility === 'invite-only'
-                            ? '이 팀은 초대받은 사용자만 설치할 수 있습니다. 로그인이 필요합니다.'
-                            : '이 팀은 로그인이 필요합니다.',
-                    }));
+                    if (json) {
+                        console.error(JSON.stringify({
+                            error: 'LOGIN_REQUIRED',
+                            visibility,
+                            slug,
+                            message: '이 팀은 Space 멤버만 설치할 수 있습니다. 로그인이 필요합니다.',
+                        }));
+                    }
+                    else {
+                        console.error('\x1b[31m이 팀은 Space 멤버만 설치할 수 있습니다. relay login 을 먼저 실행하세요.\x1b[0m');
+                    }
                     process.exit(1);
                 }
             }
@@ -70,12 +173,13 @@ function registerInstall(program) {
                 return count;
             }
             const fileCount = countFiles(teamDir);
-            // 6. Record in installed.json
+            // 6. Record in installed.json (space_slug 포함)
             const installed = (0, config_js_1.loadInstalled)();
             installed[slug] = {
                 version: team.version,
                 installed_at: new Date().toISOString(),
                 files: [teamDir],
+                ...(spaceTarget ? { space_slug: spaceTarget.spaceSlug } : {}),
             };
             (0, config_js_1.saveInstalled)(installed);
             // 7. Report install (non-blocking)
@@ -88,6 +192,7 @@ function registerInstall(program) {
                 commands: team.commands,
                 files: fileCount,
                 install_path: teamDir,
+                ...(spaceTarget ? { space_slug: spaceTarget.spaceSlug } : {}),
             };
             if (json) {
                 console.log(JSON.stringify(result));
@@ -139,6 +244,14 @@ function registerInstall(program) {
                         console.log(`\n  📖 사용가이드: ${guideHtmlPath}`);
                     }
                 }
+                // Usage hint
+                if (team.commands && team.commands.length > 0) {
+                    console.log(`\n\x1b[33m💡 시작하려면 채팅에 아래 명령어를 입력하세요:\x1b[0m`);
+                    console.log(`  \x1b[1m/${team.commands[0].name}\x1b[0m`);
+                }
+                else {
+                    console.log(`\n\x1b[33m💡 설치 완료! AI 에이전트에서 사용할 수 있습니다.\x1b[0m`);
+                }
                 console.log('\n  에이전트가 /relay-install로 환경을 구성합니다.');
             }
         }

package/dist/commands/join.d.ts

@@ -0,0 +1,5 @@
+import { Command } from 'commander';
+export declare function joinSpace(spaceSlug: string, code: string): Promise<{
+    spaceName: string;
+}>;
+export declare function registerJoin(program: Command): void;

package/dist/commands/join.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.joinSpace = joinSpace;
+exports.registerJoin = registerJoin;
+const config_js_1 = require("../lib/config.js");
+const init_js_1 = require("./init.js");
+async function fetchSpaceTeams(spaceSlug, token) {
+    const res = await fetch(`${config_js_1.API_URL}/api/spaces/${spaceSlug}/teams`, {
+        headers: { Authorization: `Bearer ${token}` },
+        signal: AbortSignal.timeout(5000),
+    });
+    if (!res.ok)
+        throw new Error(`${res.status}`);
+    const data = (await res.json());
+    if (Array.isArray(data))
+        return data;
+    return data.teams ?? [];
+}
+async function joinSpace(spaceSlug, code) {
+    const token = await (0, config_js_1.getValidToken)();
+    if (!token) {
+        throw new Error('LOGIN_REQUIRED');
+    }
+    const res = await fetch(`${config_js_1.API_URL}/api/spaces/${spaceSlug}/join`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${token}`,
+        },
+        body: JSON.stringify({ code }),
+    });
+    const body = (await res.json().catch(() => ({})));
+    if (!res.ok) {
+        const errCode = body.error ?? String(res.status);
+        switch (errCode) {
+            case 'INVALID_CODE':
+                throw new Error('초대 코드가 올바르지 않습니다.');
+            case 'EXPIRED_CODE':
+                throw new Error('초대 코드가 만료되었습니다.');
+            case 'ALREADY_MEMBER':
+                throw new Error('ALREADY_MEMBER');
+            default:
+                throw new Error(body.message ?? `Space 가입 실패 (${res.status})`);
+        }
+    }
+    return { spaceName: body.space_name ?? spaceSlug };
+}
+function registerJoin(program) {
+    program
+        .command('join <slug>')
+        .description('Space에 초대 코드로 가입합니다')
+        .requiredOption('--code <code>', '초대 코드 (UUID)')
+        .action(async (slug, opts) => {
+        const json = program.opts().json ?? false;
+        if (!(0, init_js_1.hasGlobalUserCommands)()) {
+            if (!json) {
+                console.error('\x1b[33m⚠ relay init이 실행되지 않았습니다. 먼저 relay init을 실행하세요.\x1b[0m');
+            }
+            else {
+                console.error(JSON.stringify({ error: 'NOT_INITIALIZED', message: 'relay init을 먼저 실행하세요.' }));
+            }
+            process.exit(1);
+        }
+        try {
+            const { spaceName } = await joinSpace(slug, opts.code);
+            if (json) {
+                // best-effort: fetch teams for JSON response
+                let teams = [];
+                try {
+                    const token = await (0, config_js_1.getValidToken)();
+                    if (token)
+                        teams = await fetchSpaceTeams(slug, token);
+                }
+                catch {
+                    // ignore
+                }
+                console.log(JSON.stringify({ status: 'ok', space: slug, space_name: spaceName, teams: teams.map((t) => ({ slug: t.slug, name: t.name })) }));
+            }
+            else {
+                console.log(`\x1b[32m✅ ${spaceName} Space에 가입했습니다\x1b[0m`);
+                // best-effort: show available teams
+                try {
+                    const token = await (0, config_js_1.getValidToken)();
+                    if (token) {
+                        const teams = await fetchSpaceTeams(slug, token);
+                        if (teams.length === 0) {
+                            console.log('\n아직 추가된 팀이 없습니다.');
+                        }
+                        else {
+                            console.log('\n\x1b[1m📦 사용 가능한 팀:\x1b[0m');
+                            for (const t of teams) {
+                                const desc = t.description ? `  \x1b[90m— ${t.description}\x1b[0m` : '';
+                                console.log(`  \x1b[36m•\x1b[0m \x1b[1m${t.slug}\x1b[0m${desc}`);
+                            }
+                            console.log(`\n\x1b[33m💡 설치: relay install @spaces/${slug}/<팀슬러그>\x1b[0m`);
+                        }
+                    }
+                }
+                catch {
+                    // ignore — success message was already shown
+                }
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (message === 'ALREADY_MEMBER') {
+                if (json) {
+                    console.log(JSON.stringify({ status: 'already_member', space: slug }));
+                }
+                else {
+                    console.log(`\x1b[33m이미 ${slug} Space의 멤버입니다.\x1b[0m`);
+                }
+                return;
+            }
+            if (message === 'LOGIN_REQUIRED') {
+                if (json) {
+                    console.error(JSON.stringify({
+                        error: 'LOGIN_REQUIRED',
+                        message: '로그인이 필요합니다. relay login 을 먼저 실행하세요.',
+                    }));
+                }
+                else {
+                    console.error('\x1b[31m오류: 로그인이 필요합니다.\x1b[0m');
+                    console.error('  relay login 을 먼저 실행하세요.');
+                }
+                process.exit(1);
+            }
+            if (json) {
+                console.error(JSON.stringify({ error: 'JOIN_FAILED', message }));
+            }
+            else {
+                console.error(`\x1b[31m오류: ${message}\x1b[0m`);
+            }
+            process.exit(1);
+        }
+    });
+}

package/dist/commands/list.js

@@ -2,12 +2,73 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerList = registerList;
 const config_js_1 = require("../lib/config.js");
+async function fetchSpaceTeamList(spaceSlug, token) {
+    const res = await fetch(`${config_js_1.API_URL}/api/spaces/${spaceSlug}/teams`, {
+        headers: { Authorization: `Bearer ${token}` },
+        signal: AbortSignal.timeout(8000),
+    });
+    if (!res.ok) {
+        const body = await res.text();
+        throw new Error(`Space 팀 목록 조회 실패 (${res.status}): ${body}`);
+    }
+    const data = (await res.json());
+    if (Array.isArray(data))
+        return data;
+    return data.teams ?? [];
+}
 function registerList(program) {
     program
         .command('list')
         .description('설치된 에이전트 팀 목록')
-        .action(() => {
+        .option('--space <slug>', 'Space 마켓플레이스의 팀 목록 조회')
+        .action(async (opts) => {
         const json = program.opts().json ?? false;
+        // --space 옵션: Space 마켓플레이스 팀 목록
+        if (opts.space) {
+            const spaceSlug = opts.space;
+            const token = await (0, config_js_1.getValidToken)();
+            if (!token) {
+                if (json) {
+                    console.error(JSON.stringify({ error: 'LOGIN_REQUIRED', message: '로그인이 필요합니다. relay login을 먼저 실행하세요.' }));
+                }
+                else {
+                    console.error('\x1b[31m오류: 로그인이 필요합니다.\x1b[0m');
+                    console.error('  relay login을 먼저 실행하세요.');
+                }
+                process.exit(1);
+            }
+            try {
+                const teams = await fetchSpaceTeamList(spaceSlug, token);
+                if (json) {
+                    console.log(JSON.stringify({ space: spaceSlug, teams }));
+                    return;
+                }
+                if (teams.length === 0) {
+                    console.log(`\n${spaceSlug} Space에 추가된 팀이 없습니다.`);
+                    return;
+                }
+                console.log(`\n\x1b[1m${spaceSlug} Space 팀 목록\x1b[0m (${teams.length}개):\n`);
+                for (const t of teams) {
+                    const desc = t.description
+                        ? `  \x1b[90m${t.description.length > 50 ? t.description.slice(0, 50) + '...' : t.description}\x1b[0m`
+                        : '';
+                    console.log(`  \x1b[36m${t.slug}\x1b[0m  \x1b[1m${t.name}\x1b[0m${desc}`);
+                }
+                console.log(`\n\x1b[33m💡 설치: relay install @spaces/${spaceSlug}/<팀슬러그>\x1b[0m`);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                if (json) {
+                    console.error(JSON.stringify({ error: 'FETCH_FAILED', message }));
+                }
+                else {
+                    console.error(`\x1b[31m오류: ${message}\x1b[0m`);
+                }
+                process.exit(1);
+            }
+            return;
+        }
+        // 기본 동작: 로컬에 설치된 팀 목록
         const installed = (0, config_js_1.loadInstalled)();
         const entries = Object.entries(installed);
         const installedList = entries.map(([slug, info]) => ({

package/dist/commands/login.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerLogin = registerLogin;
 const http_1 = __importDefault(require("http"));
+const readline_1 = __importDefault(require("readline"));
 const child_process_1 = require("child_process");
 const config_js_1 = require("../lib/config.js");
 function openBrowser(url) {
@@ -58,6 +59,10 @@ const SUCCESS_HTML = `<!DOCTYPE html>
 </body></html>`;
 function waitForToken(port) {
     return new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => {
+            server.close();
+            reject(new Error('로그인 시간이 초과되었습니다 (5분)'));
+        }, 5 * 60 * 1000);
         const server = http_1.default.createServer(async (req, res) => {
             const url = new URL(req.url ?? '/', `http://localhost:${port}`);
             if (url.pathname === '/callback') {
@@ -76,6 +81,7 @@ function waitForToken(port) {
                 const expires_at = expires_at_raw ? Number(expires_at_raw) : undefined;
                 res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
                 res.end(SUCCESS_HTML);
+                clearTimeout(timeout);
                 server.close();
                 if (token) {
                     resolve({ token, refresh_token, expires_at });
@@ -90,11 +96,6 @@ function waitForToken(port) {
             }
         });
         server.listen(port, '127.0.0.1');
-        // Timeout after 5 minutes
-        setTimeout(() => {
-            server.close();
-            reject(new Error('로그인 시간이 초과되었습니다 (5분)'));
-        }, 5 * 60 * 1000);
     });
 }
 function findAvailablePort() {
@@ -112,11 +113,109 @@ function findAvailablePort() {
         });
     });
 }
+function promptLine(rl, question) {
+    return new Promise((resolve) => rl.question(question, resolve));
+}
+function promptPassword(question) {
+    return new Promise((resolve) => {
+        const rl = readline_1.default.createInterface({ input: process.stdin, output: process.stdout });
+        process.stdout.write(question);
+        // Hide input
+        const stdin = process.stdin;
+        if (stdin.isTTY)
+            stdin.setRawMode(true);
+        let input = '';
+        process.stdin.resume();
+        process.stdin.setEncoding('utf8');
+        const onData = (ch) => {
+            if (ch === '\n' || ch === '\r' || ch === '\u0004') {
+                if (stdin.isTTY)
+                    stdin.setRawMode(false);
+                process.stdout.write('\n');
+                process.stdin.removeListener('data', onData);
+                rl.close();
+                resolve(input);
+            }
+            else if (ch === '\u0003') {
+                process.exit(1);
+            }
+            else if (ch === '\u007f') {
+                input = input.slice(0, -1);
+            }
+            else {
+                input += ch;
+            }
+        };
+        process.stdin.on('data', onData);
+    });
+}
+async function loginWithBrowser(provider, json) {
+    const port = await findAvailablePort();
+    const loginUrl = `${config_js_1.API_URL}/auth/cli-login?port=${port}&provider=${provider}`;
+    if (!json) {
+        const providerName = provider === 'github' ? 'GitHub' : '카카오';
+        console.error(`브라우저에서 ${providerName} 로그인을 진행합니다...`);
+    }
+    openBrowser(loginUrl);
+    return waitForToken(port);
+}
+async function loginWithEmail(json) {
+    const rl = readline_1.default.createInterface({ input: process.stdin, output: process.stdout });
+    if (!json) {
+        console.error('이메일로 로그인합니다.');
+    }
+    let email;
+    let password;
+    try {
+        email = (await promptLine(rl, '이메일: ')).trim();
+        rl.close();
+        password = await promptPassword('비밀번호: ');
+    }
+    catch {
+        rl.close();
+        throw new Error('입력이 취소되었습니다');
+    }
+    const res = await fetch(`${config_js_1.API_URL}/api/auth/email-login`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ email, password }),
+    });
+    if (!res.ok) {
+        const body = (await res.json().catch(() => ({})));
+        const msg = body.error ?? '이메일 또는 비밀번호가 올바르지 않습니다.';
+        throw new Error(msg);
+    }
+    const data = (await res.json());
+    return {
+        token: data.access_token,
+        refresh_token: data.refresh_token,
+        expires_at: data.expires_at,
+    };
+}
+async function selectProvider(json) {
+    if (json)
+        return 'github';
+    const rl = readline_1.default.createInterface({ input: process.stdin, output: process.stdout });
+    console.error('');
+    console.error('로그인 방법을 선택하세요:');
+    console.error('  1) GitHub');
+    console.error('  2) 카카오');
+    console.error('  3) 이메일 / 비밀번호');
+    console.error('');
+    const answer = (await promptLine(rl, '선택 (기본값: 1): ')).trim();
+    rl.close();
+    if (answer === '2')
+        return 'kakao';
+    if (answer === '3')
+        return 'email';
+    return 'github';
+}
 function registerLogin(program) {
     program
         .command('login')
         .description('RelayAX 계정에 로그인합니다')
         .option('--token <token>', '직접 토큰 입력 (브라우저 없이)')
+        .option('--provider <provider>', '로그인 제공자 (github | kakao | email)')
         .action(async (opts) => {
         const json = program.opts().json ?? false;
         (0, config_js_1.ensureGlobalRelayDir)();
@@ -125,18 +224,32 @@ function registerLogin(program) {
         let expiresAt;
         if (!accessToken) {
             try {
-                const port = await findAvailablePort();
-                const loginUrl = `${config_js_1.API_URL}/auth/cli-login?port=${port}`;
-                console.error('브라우저에서 로그인을 진행합니다...');
-                openBrowser(loginUrl);
-                const loginResult = await waitForToken(port);
+                let provider = opts.provider;
+                if (!provider) {
+                    provider = await selectProvider(json);
+                }
+                let loginResult;
+                if (provider === 'email') {
+                    loginResult = await loginWithEmail(json);
+                }
+                else if (provider === 'kakao') {
+                    loginResult = await loginWithBrowser('kakao', json);
+                }
+                else {
+                    loginResult = await loginWithBrowser('github', json);
+                }
                 accessToken = loginResult.token;
                 refreshToken = loginResult.refresh_token;
                 expiresAt = loginResult.expires_at;
             }
             catch (err) {
                 const msg = err instanceof Error ? err.message : '로그인 실패';
-                console.error(JSON.stringify({ error: 'LOGIN_FAILED', message: msg }));
+                if (json) {
+                    console.error(JSON.stringify({ error: 'LOGIN_FAILED', message: msg }));
+                }
+                else {
+                    console.error(`\x1b[31m오류: ${msg}\x1b[0m`);
+                }
                 process.exit(1);
             }
         }

package/dist/commands/publish.js

@@ -51,10 +51,9 @@ function parseRelayYaml(content) {
     }
     const requires = raw.requires;
     const rawVisibility = String(raw.visibility ?? '');
-    const visibility = rawVisibility === 'login-only' ? 'login-only'
-        : rawVisibility === 'invite-only' ? 'invite-only'
-            : rawVisibility === 'public' ? 'public'
-                : undefined;
+    const visibility = rawVisibility === 'private' ? 'private'
+        : rawVisibility === 'public' ? 'public'
+            : undefined;
     return {
         name: String(raw.name ?? ''),
         slug: String(raw.slug ?? ''),
@@ -447,14 +446,13 @@ function registerPublish(program) {
             const visibility = await promptSelect({
                 message: '공개 범위:',
                 choices: [
-                    { name: '전체 공개', value: 'public' },
-                    { name: '로그인 사용자만', value: 'login-only' },
-                    { name: '초대 코드 필요', value: 'invite-only' },
+                    { name: '공개', value: 'public' },
+                    { name: '비공개 (Space 멤버만)', value: 'private' },
                 ],
             });
             console.error('\n\x1b[2m💡 프로필에 연락처를 설정하면 설치 시 명함이 전달됩니다: www.relayax.com/dashboard/profile\x1b[0m');
-            if (visibility === 'invite-only') {
-                console.error('\x1b[2m💡 invite-only 팀은 웹 대시보드에서 사용자를 초대하세요: www.relayax.com/dashboard/teams\x1b[0m');
+            if (visibility === 'private') {
+                console.error('\x1b[2m💡 비공개 팀은 Space를 통해 멤버를 관리하세요: www.relayax.com/dashboard/teams\x1b[0m');
             }
             console.error('');
             const tags = tagsRaw
@@ -483,6 +481,58 @@ function registerPublish(program) {
             }));
             process.exit(1);
         }
+        // Visibility validation: must be explicitly set
+        if (!config.visibility) {
+            if (isTTY) {
+                const { select: promptSelect } = await import('@inquirer/prompts');
+                console.error('\n\x1b[33m⚠ relay.yaml에 visibility가 설정되지 않았습니다.\x1b[0m');
+                // Show user's spaces to help decide
+                try {
+                    const { fetchMySpaces } = await import('./spaces.js');
+                    const spaceToken = opts.token ?? process.env.RELAY_TOKEN ?? await (0, config_js_1.getValidToken)();
+                    if (spaceToken) {
+                        const spaces = await fetchMySpaces(spaceToken);
+                        const nonPersonal = spaces.filter((s) => !s.is_personal);
+                        if (nonPersonal.length > 0) {
+                            console.error(`\n  내 Space:`);
+                            for (const s of nonPersonal) {
+                                console.error(`    \x1b[36m${s.slug}\x1b[0m — ${s.name}`);
+                            }
+                            console.error(`\n  비공개로 설정하면 위 Space 멤버만 접근할 수 있습니다.\n`);
+                        }
+                    }
+                }
+                catch {
+                    // Space 조회 실패는 무시 — visibility 선택은 계속 진행
+                }
+                config.visibility = await promptSelect({
+                    message: '공개 범위를 선택하세요:',
+                    choices: [
+                        { name: '공개 — 마켓플레이스에 누구나 검색·설치', value: 'public' },
+                        { name: '비공개 — Space 멤버만 접근', value: 'private' },
+                    ],
+                });
+                // Save back to relay.yaml
+                const yamlData = js_yaml_1.default.load(yamlContent);
+                yamlData.visibility = config.visibility;
+                fs_1.default.writeFileSync(relayYamlPath, js_yaml_1.default.dump(yamlData, { lineWidth: 120 }), 'utf-8');
+                console.error(`  → relay.yaml에 visibility: ${config.visibility} 저장됨\n`);
+            }
+            else {
+                console.error(JSON.stringify({
+                    error: 'MISSING_VISIBILITY',
+                    message: 'relay.yaml에 visibility (public 또는 private)를 설정해주세요.',
+                }));
+                process.exit(1);
+            }
+        }
+        // Confirm visibility before publish
+        if (isTTY) {
+            const visLabel = config.visibility === 'public'
+                ? '\x1b[32m공개\x1b[0m (마켓플레이스에 누구나 검색·설치)'
+                : '\x1b[33m비공개\x1b[0m (Space 멤버만 접근)';
+            console.error(`공개 범위: ${visLabel}`);
+        }
         // Profile hint
         if (isTTY) {
             console.error('💡 프로필에 연락처를 설정하면 설치 시 명함이 전달됩니다: www.relayax.com/dashboard/profile');

package/dist/commands/spaces.d.ts

@@ -0,0 +1,11 @@
+import { Command } from 'commander';
+export interface SpaceInfo {
+    id: string;
+    slug: string;
+    name: string;
+    description: string | null;
+    is_personal: boolean;
+    role: string;
+}
+export declare function fetchMySpaces(token: string): Promise<SpaceInfo[]>;
+export declare function registerSpaces(program: Command): void;

package/dist/commands/spaces.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchMySpaces = fetchMySpaces;
+exports.registerSpaces = registerSpaces;
+const config_js_1 = require("../lib/config.js");
+async function fetchMySpaces(token) {
+    const res = await fetch(`${config_js_1.API_URL}/api/spaces`, {
+        headers: { Authorization: `Bearer ${token}` },
+        signal: AbortSignal.timeout(8000),
+    });
+    if (!res.ok) {
+        throw new Error(`Space 목록 조회 실패 (${res.status})`);
+    }
+    return (await res.json());
+}
+function registerSpaces(program) {
+    program
+        .command('spaces')
+        .description('내 Space 목록을 확인합니다')
+        .action(async () => {
+        const json = program.opts().json ?? false;
+        const token = await (0, config_js_1.getValidToken)();
+        if (!token) {
+            if (json) {
+                console.error(JSON.stringify({ error: 'LOGIN_REQUIRED', message: '로그인이 필요합니다. relay login을 먼저 실행하세요.' }));
+            }
+            else {
+                console.error('\x1b[31m오류: 로그인이 필요합니다.\x1b[0m');
+                console.error('  relay login을 먼저 실행하세요.');
+            }
+            process.exit(1);
+        }
+        try {
+            const spaces = await fetchMySpaces(token);
+            if (json) {
+                console.log(JSON.stringify({ spaces }));
+                return;
+            }
+            const personal = spaces.find((s) => s.is_personal);
+            const others = spaces.filter((s) => !s.is_personal);
+            if (personal) {
+                console.log(`\n\x1b[90m개인 스페이스:\x1b[0m`);
+                console.log(`  \x1b[36m${personal.slug}\x1b[0m  \x1b[1m${personal.name}\x1b[0m`);
+            }
+            if (others.length > 0) {
+                console.log(`\n\x1b[1m내 Space\x1b[0m (${others.length}개):\n`);
+                for (const s of others) {
+                    const role = s.role === 'owner' ? '\x1b[33m소유자\x1b[0m'
+                        : s.role === 'admin' ? '\x1b[36m관리자\x1b[0m'
+                            : '\x1b[90m멤버\x1b[0m';
+                    const desc = s.description
+                        ? `  \x1b[90m${s.description.length > 40 ? s.description.slice(0, 40) + '...' : s.description}\x1b[0m`
+                        : '';
+                    console.log(`  \x1b[36m${s.slug}\x1b[0m  \x1b[1m${s.name}\x1b[0m  ${role}${desc}`);
+                }
+            }
+            if (!personal && others.length === 0) {
+                console.log('\nSpace가 없습니다.');
+                console.log('\x1b[33m💡 Space를 만들려면: www.relayax.com/spaces/new\x1b[0m');
+            }
+            if (others.length > 0) {
+                console.log(`\n\x1b[33m💡 Space 팀 목록: relay list --space <slug>\x1b[0m`);
+                console.log(`\x1b[33m💡 비공개 배포: relay.yaml에 visibility: private 설정 후 relay publish\x1b[0m`);
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (json) {
+                console.error(JSON.stringify({ error: 'FETCH_FAILED', message }));
+            }
+            else {
+                console.error(`\x1b[31m오류: ${message}\x1b[0m`);
+            }
+            process.exit(1);
+        }
+    });
+}

package/dist/commands/update.js

@@ -13,7 +13,7 @@ function registerUpdate(program) {
         .command('update <slug>')
         .description('설치된 에이전트 팀을 최신 버전으로 업데이트합니다')
         .option('--path <install_path>', '설치 경로 지정 (기본: ./.claude)')
-        .option('--code <code>', '초대 코드 (invite-only 팀 업데이트 시 필요)')
+        .option('--code <code>', '초대 코드 (비공개 팀 업데이트 시 필요)')
         .action(async (slugInput, opts) => {
         const json = program.opts().json ?? false;
         const installPath = (0, config_js_1.getInstallPath)(opts.path);
@@ -52,16 +52,10 @@ function registerUpdate(program) {
             }
             // Visibility check
             const visibility = team.visibility ?? 'public';
-            if (visibility === 'login-only') {
+            if (visibility === 'private') {
                 const token = await (0, config_js_1.getValidToken)();
                 if (!token) {
-                    console.error('이 팀은 로그인이 필요합니다. `relay login`을 먼저 실행하세요.');
-                    process.exit(1);
-                }
-            }
-            else if (visibility === 'invite-only') {
-                if (!opts.code) {
-                    console.error('초대 코드가 필요합니다. `relay update ' + slug + ' --code <code>`로 업데이트하세요.');
+                    console.error('이 팀은 Space 멤버만 업데이트할 수 있습니다. `relay login`을 먼저 실행하세요.');
                     process.exit(1);
                 }
             }

package/dist/index.js

@@ -16,6 +16,8 @@ const outdated_js_1 = require("./commands/outdated.js");
 const check_update_js_1 = require("./commands/check-update.js");
 const follow_js_1 = require("./commands/follow.js");
 const changelog_js_1 = require("./commands/changelog.js");
+const join_js_1 = require("./commands/join.js");
+const spaces_js_1 = require("./commands/spaces.js");
 // eslint-disable-next-line @typescript-eslint/no-var-requires
 const pkg = require('../package.json');
 const program = new commander_1.Command();
@@ -38,4 +40,6 @@ program
 (0, check_update_js_1.registerCheckUpdate)(program);
 (0, follow_js_1.registerFollow)(program);
 (0, changelog_js_1.registerChangelog)(program);
+(0, join_js_1.registerJoin)(program);
+(0, spaces_js_1.registerSpaces)(program);
 program.parse();

package/dist/lib/api.d.ts

@@ -8,6 +8,11 @@ export interface TeamVersionInfo {
 }
 export declare function fetchTeamVersions(slug: string): Promise<TeamVersionInfo[]>;
 export declare function reportInstall(slug: string, version?: string): Promise<void>;
+/**
+ * Space 팀 설치: 멤버십 검증 + install count 증가 + 팀 메타데이터 반환을 한 번에 처리.
+ * POST /api/spaces/{spaceSlug}/teams/{teamSlug}/install
+ */
+export declare function installSpaceTeam(spaceSlug: string, teamSlug: string, version?: string): Promise<TeamRegistryInfo>;
 export interface ResolvedSlug {
     owner: string;
     name: string;

package/dist/lib/api.js

@@ -4,6 +4,7 @@ exports.fetchTeamInfo = fetchTeamInfo;
 exports.searchTeams = searchTeams;
 exports.fetchTeamVersions = fetchTeamVersions;
 exports.reportInstall = reportInstall;
+exports.installSpaceTeam = installSpaceTeam;
 exports.resolveSlugFromServer = resolveSlugFromServer;
 exports.sendUsagePing = sendUsagePing;
 exports.followBuilder = followBuilder;
@@ -62,6 +63,31 @@ async function reportInstall(slug, version) {
         // non-critical: ignore errors
     });
 }
+/**
+ * Space 팀 설치: 멤버십 검증 + install count 증가 + 팀 메타데이터 반환을 한 번에 처리.
+ * POST /api/spaces/{spaceSlug}/teams/{teamSlug}/install
+ */
+async function installSpaceTeam(spaceSlug, teamSlug, version) {
+    const url = `${config_js_1.API_URL}/api/spaces/${spaceSlug}/teams/${teamSlug}/install`;
+    const headers = { 'Content-Type': 'application/json' };
+    const token = await (0, config_js_1.getValidToken)();
+    if (token) {
+        headers['Authorization'] = `Bearer ${token}`;
+    }
+    const body = {};
+    if (version)
+        body.version = version;
+    const res = await fetch(url, {
+        method: 'POST',
+        headers,
+        body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`Space 팀 설치 실패 (${res.status}): ${text}`);
+    }
+    return res.json();
+}
 async function resolveSlugFromServer(name) {
     const url = `${config_js_1.API_URL}/api/registry/resolve?name=${encodeURIComponent(name)}`;
     const res = await fetch(url, { signal: AbortSignal.timeout(5000) });

package/dist/lib/command-adapter.js

@@ -108,7 +108,10 @@ exports.USER_COMMANDS = [
 - 업데이트 여부와 관계없이 설치를 계속 진행합니다.
 
 ### 1. 팀 패키지 다운로드
-- \`relay install <@author/slug>\` 명령어를 실행합니다.
+- Public 마켓 팀: \`relay install <@author/slug>\` 명령어를 실행합니다.
+- Space 팀: \`relay install @spaces/<space-slug>/<team-slug>\` 명령어를 실행합니다.
+  - Space 가입이 필요하면: \`relay join <space-slug> --code <invite-code>\` 를 먼저 실행합니다.
+  - 또는 \`relay install @spaces/<space-slug>/<team-slug> --join-code <code>\` 로 가입+설치를 한번에 할 수 있습니다.
 - 패키지가 \`.relay/teams/<slug>/\`에 다운로드됩니다.
 
 ### 2. 패키지 내용 확인
@@ -160,7 +163,13 @@ ${BUSINESS_CARD_FORMAT}
 → commands/cardnews.md → .claude/commands/cardnews.md 복사
 → skills/pdf-gen.md → .claude/skills/pdf-gen.md 복사
 → requires 확인: ✓ playwright 설치됨, ✓ sharp 설치됨
-→ "✓ 설치 완료! /cardnews를 사용해볼까요?"`,
+→ "✓ 설치 완료! /cardnews를 사용해볼까요?"
+
+사용자: /relay-install @spaces/bobusan/pm-bot
+→ relay install @spaces/bobusan/pm-bot 실행
+→ Space 멤버 확인 → 정상
+→ 패키지 다운로드 및 배치
+→ "✓ 설치 완료!"`,
     },
     {
         id: 'relay-list',
@@ -176,13 +185,23 @@ ${BUSINESS_CARD_FORMAT}
    - 사용 가능한 커맨드
 3. 설치된 팀이 없으면 \`/relay-explore\`로 팀을 탐색해보라고 안내합니다.
 
+### Space 팀 목록 확인
+- 특정 Space에서 사용 가능한 팀 목록을 보려면: \`relay list --space <space-slug> --json\`
+- Space에 가입되어 있어야 합니다.
+
 ## 예시
 
 사용자: /relay-list
 → relay list --json 실행
 → "2개 팀이 설치되어 있어요:"
 → "  @example/contents-team v1.2.0 (2일 전 설치) - /cardnews, /pdf-report"
-→ "  qa-team v0.5.1 (1주 전 설치) - /qa, /qa-only"`,
+→ "  qa-team v0.5.1 (1주 전 설치) - /qa, /qa-only"
+
+사용자: /relay-list --space bobusan
+→ relay list --space bobusan --json 실행
+→ "bobusan Space에서 설치 가능한 팀:"
+→ "  pm-bot — 프로젝트 관리 봇"
+→ "  cs-bot — 고객 응대 봇"`,
     },
     {
         id: 'relay-update',
@@ -372,7 +391,17 @@ requires:
 - tags: 팀 특성에 맞는 태그를 추천합니다.
 - 사용자에게 확인: "이대로 배포할까요?"
 
-### 7. .relay/relay.yaml 업데이트
+### 7. 공개 범위 확인 (필수)
+- .relay/relay.yaml에 \`visibility\`가 반드시 설정되어 있어야 합니다.
+- 설정되어 있지 않으면 빌더에게 반드시 물어봅니다:
+  - "공개 (마켓플레이스에 누구나 검색·설치 가능)" vs "비공개 (Space 멤버만 접근)"
+- 선택 결과를 relay.yaml에 저장합니다.
+- 이미 설정되어 있으면 현재 값을 확인합니다:
+  - 공개인 경우: "⚠ 이 팀은 **공개**로 설정되어 있어 마켓플레이스에 노출됩니다. 맞나요?"
+  - 비공개인 경우: "이 팀은 **비공개**로 설정되어 Space 멤버만 접근 가능합니다."
+- 빌더가 변경을 원하면 relay.yaml을 업데이트합니다.
+
+### 8. .relay/relay.yaml 업데이트
 - 메타데이터, requires, 포트폴리오 슬롯을 .relay/relay.yaml에 반영합니다.
 
 \`\`\`yaml
@@ -387,7 +416,7 @@ portfolio:
       title: "카드뉴스 예시"
 \`\`\`
 
-### 8. 배포
+### 9. 배포
 - \`relay publish\` 명령어를 실행합니다.
 - 배포 결과와 마켓플레이스 URL을 보여줍니다.
 ${BUSINESS_CARD_FORMAT}

package/dist/types.d.ts

@@ -8,6 +8,8 @@ export interface InstalledTeam {
     installed_at: string;
     files: string[];
     type?: 'team' | 'system';
+    /** Space 소속 팀인 경우 Space slug */
+    space_slug?: string;
 }
 /** 키는 scoped slug 포맷: "@owner/name" */
 export interface InstalledRegistry {
@@ -30,7 +32,7 @@ export interface TeamRegistryInfo {
     tags?: string[];
     install_count?: number;
     requires?: Record<string, unknown>;
-    visibility?: "public" | "login-only" | "invite-only";
+    visibility?: "public" | "private";
     welcome?: string | null;
     contact?: Record<string, string> | null;
     author?: {

package/package.json

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