relayax-cli 0.3.43 → 0.3.44

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/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/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/package.json

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