shellbase 0.1.1 → 0.1.3

package/README.md

@@ -38,6 +38,13 @@ shellbase start --dir ~/projects/my-app --name "내 노트북"
 `--auto-approve` 를 쓰면 폰에서 접속할 때마다 물어보지 않고 바로 승인해요. 편하지만, 내 계정에
 로그인할 수 있는 사람은 누구나 바로 입력할 수 있게 되니 신뢰할 수 있는 환경에서만 쓰세요.
 
+### 같은 컴퓨터에서 여러 개 동시에 켜기
+
+터미널을 새로 열어서 다른 폴더로 `shellbase start` 를 한 번 더 실행하면, 별개의 세션으로 등록돼서
+폰 목록에 폴더별로 따로 떠요(예: `내PC · project-a`, `내PC · project-b`). 프로젝트마다 세션을 하나씩
+켜두고 폰에서 왔다갔다 접속할 수 있어요. `Ctrl+C` 로 정상 종료하면 그 세션은 목록에서 자동으로
+지워지고, 강제 종료 등으로 남아있는 세션은 폰 목록에서 휴지통 아이콘으로 직접 지울 수 있어요.
+
 ## 참고
 
 - `node-pty` 를 사용해서 설치 시 네이티브 모듈을 컴파일합니다. macOS는 Xcode Command Line Tools,
@@ -45,3 +52,62 @@ shellbase start --dir ~/projects/my-app --name "내 노트북"
   필요할 수 있어요.
 - 터미널 내용은 기기별 키로 암호화돼서 전송되고, 모바일에서 접속을 시도할 때마다 데스크톱에서
   직접 승인해야 입력이 가능합니다.
+
+## ⚠️ `shellbase start` 는 컴퓨터가 꺼지거나 재부팅되면 같이 꺼져요
+
+이건 각자의 컴퓨터에서 직접 관리해야 하는 부분입니다 — ShellBase 서비스가 대신 재시작해주지 않아요.
+`shellbase start` 를 실행해둔 터미널을 닫거나, 컴퓨터를 껐다 켜거나, 프로세스가 죽으면 그 세션은
+끝나고, 다시 접속하려면 **직접 `shellbase start` 를 다시 실행**해야 합니다.
+
+컴퓨터가 꺼지지 않는 이상 자동으로 살아있게 하고 싶다면(예: 항상 켜져 있는 리눅스 서버), 아래처럼
+OS의 자동 재시작 기능을 직접 설정하면 됩니다. **실제로 테스트해서 확인한 방법이에요:**
+
+### Linux (systemd, 실제 검증됨)
+
+```bash
+mkdir -p ~/.config/systemd/user
+cat > ~/.config/systemd/user/shellbase.service << 'EOF'
+[Unit]
+Description=ShellBase desktop agent
+After=network-online.target
+
+[Service]
+Environment=PATH=/usr/local/bin:/usr/bin:/bin:%h/.nvm/current/bin
+ExecStart=%h/.local/bin/shellbase start --dir %h --auto-approve
+Restart=always
+RestartSec=3
+
+[Install]
+WantedBy=default.target
+EOF
+
+systemctl --user daemon-reload
+systemctl --user enable --now shellbase.service
+```
+
+> **주의할 점 2가지 (직접 겪은 문제라 적어둡니다):**
+> 1. `ExecStart` 의 `shellbase` 경로는 `which shellbase` 로 직접 확인해서 넣으세요 — systemd 서비스는
+>    평소 터미널의 PATH를 그대로 물려받지 않아서, node/shellbase를 못 찾는 경우가 흔해요.
+>    (`Environment=PATH=...` 에도 같은 폴더를 넣어야 해요.)
+> 2. 로그인 세션 없이(원격 SSH 접속도 안 하고) 완전히 백그라운드로 계속 떠있게 하려면
+>    `loginctl enable-linger $(whoami)` 도 한 번 실행해야 해요. 안 하면 로그아웃할 때 같이 꺼져요.
+>
+> `--auto-approve` 는 선택이에요 — 뺴면 폰에서 접속할 때마다 이 컴퓨터 쪽 로그(`journalctl --user -u shellbase -f`)에서 승인해야 하는데, 화면을 안 보는 서버 환경이라면 사실상 승인을 못 하게 되니 이런 무인 서버 상황에서는 `--auto-approve` 를 켜두는 걸 권장해요.
+
+### macOS
+
+`launchd` 로 같은 걸 할 수 있어요 (`~/Library/LaunchAgents/` 에 `.plist` 등록, `KeepAlive: true`).
+아직 저희가 macOS에서 직접 검증은 못 했어요 — 해보시고 문제 있으면 알려주세요.
+
+### Windows
+
+작업 스케줄러(Task Scheduler)에서 "로그온 시 시작" + "실패 시 다시 시작" 옵션으로 등록하면 비슷하게
+됩니다. 아직 저희가 Windows에서 직접 검증은 못 했어요.
+
+### Docker로 하고 싶다면
+
+`docker run --restart=always` 로 "꺼지면 자동 재시작"은 되지만, **컨테이너 안은 이 컴퓨터의 실제
+환경과 분리돼 있어요** — git 설정, 설치된 프로그램, 작업 폴더들을 볼륨(`-v`)으로 일일이 연결해줘야
+컨테이너 밖 진짜 내 파일들이 보여요. 이 컴퓨터 자체를 그대로 폰에서 보고 싶다면 컨테이너보다는
+위의 systemd/launchd/작업 스케줄러처럼 호스트에 직접 설치하는 쪽을 권장해요. 반대로 "이 컴퓨터와
+무관하게 항상 떠있는 별도 개발 서버"를 원하신다면 Docker도 좋은 선택이에요.

package/dist/auth.js

@@ -1,9 +1,6 @@
 import fs from 'node:fs';
-import os from 'node:os';
-import crypto from 'node:crypto';
 import { ConnectBase } from 'connectbase-client';
-import { APP_ID, PUBLIC_KEY, CONFIG_DIR, CREDENTIALS_PATH, DEVICE_PATH } from './config.js';
-import { generateFrameKey } from './crypto.js';
+import { APP_ID, PUBLIC_KEY, CONFIG_DIR, CREDENTIALS_PATH } from './config.js';
 import { loginWithGoogle } from './google-auth.js';
 function ensureConfigDir() {
     fs.mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
@@ -20,23 +17,6 @@ function loadCredentials() {
         return null;
     }
 }
-export function loadOrCreateDevice() {
-    try {
-        return JSON.parse(fs.readFileSync(DEVICE_PATH, 'utf8'));
-    }
-    catch {
-        // realtime userId 는 UUID 형태를 "인증된 멤버 전용"으로 취급해서 거부하므로,
-        // 기기 식별자는 접두사를 붙여 UUID 로 보이지 않게 만든다.
-        const identity = {
-            deviceId: `desktop-${crypto.randomUUID()}`,
-            deviceName: os.hostname(),
-            frameKey: generateFrameKey(),
-        };
-        ensureConfigDir();
-        fs.writeFileSync(DEVICE_PATH, JSON.stringify(identity, null, 2), { mode: 0o600 });
-        return identity;
-    }
-}
 function createClient(onTokens) {
     return new ConnectBase({
         appId: APP_ID,

package/dist/config.js

@@ -11,4 +11,3 @@ export const CLI_AUTH_SESSIONS_TABLE_ID = '01a00aa0-802d-7730-88ba-b831b7405188'
 export const WEB_LOGIN_URL = 'https://shellbase.web.connectbase.world/login';
 export const CONFIG_DIR = path.join(os.homedir(), '.shellbase');
 export const CREDENTIALS_PATH = path.join(CONFIG_DIR, 'credentials.json');
-export const DEVICE_PATH = path.join(CONFIG_DIR, 'device.json');

package/dist/devices.js

@@ -1,25 +1,19 @@
 import { DEVICES_TABLE_ID } from './config.js';
 export async function registerDevice(cb, params) {
-    const { data: rows } = await cb.database.queryData(DEVICES_TABLE_ID, {
-        where: { device_id: params.deviceId },
-        limit: 1,
+    // deviceId는 `shellbase start` 를 실행할 때마다 새로 발급되므로(세션 단위 식별자),
+    // 기존 row 를 찾아 덮어쓸 필요 없이 매번 새 row 를 만든다.
+    const created = await cb.database.createData(DEVICES_TABLE_ID, {
+        data: {
+            owner_id: params.ownerId,
+            device_id: params.deviceId,
+            device_name: params.deviceName,
+            status: 'online',
+            cwd: params.cwd,
+            frame_key: params.frameKey,
+            favorite_dirs: params.favoriteDirs,
+            last_seen_at: new Date().toISOString(),
+        },
     });
-    const payload = {
-        owner_id: params.ownerId,
-        device_id: params.deviceId,
-        device_name: params.deviceName,
-        status: 'online',
-        cwd: params.cwd,
-        frame_key: params.frameKey,
-        favorite_dirs: params.favoriteDirs,
-        last_seen_at: new Date().toISOString(),
-    };
-    const existing = rows[0];
-    if (existing) {
-        await cb.database.updateData(DEVICES_TABLE_ID, existing.id, { data: payload });
-        return existing.id;
-    }
-    const created = await cb.database.createData(DEVICES_TABLE_ID, { data: payload });
     return created.id;
 }
 export async function heartbeatDevice(cb, rowId) {
@@ -27,8 +21,9 @@ export async function heartbeatDevice(cb, rowId) {
         data: { status: 'online', last_seen_at: new Date().toISOString() },
     });
 }
-export async function markDeviceOffline(cb, rowId) {
-    await cb.database.updateData(DEVICES_TABLE_ID, rowId, {
-        data: { status: 'offline', last_seen_at: new Date().toISOString() },
-    });
+// 세션이 정상 종료되면(Ctrl+C, 셸 종료 등) 목록에서 완전히 지워서 안 쓰는 항목이 쌓이지 않게 한다.
+// (예전엔 컴퓨터당 기기 하나였어서 "오프라인" 표시만 하고 남겨뒀지만, 이제 세션 하나당 새 row 라서
+// 끝난 세션을 그대로 남기면 목록이 계속 늘어나기만 함.)
+export async function unregisterDevice(cb, rowId) {
+    await cb.database.deleteData(DEVICES_TABLE_ID, rowId);
 }

package/dist/session.js

@@ -1,10 +1,12 @@
 import path from 'node:path';
+import os from 'node:os';
+import crypto from 'node:crypto';
 import * as pty from 'node-pty';
-import { requireClient, loadOrCreateDevice } from './auth.js';
+import { requireClient } from './auth.js';
 import { TERMINAL_CATEGORY } from './config.js';
 import { startSleepGuard, stopSleepGuard } from './sleep-guard.js';
-import { encryptFrame, decryptFrame } from './crypto.js';
-import { registerDevice, heartbeatDevice, markDeviceOffline } from './devices.js';
+import { encryptFrame, decryptFrame, generateFrameKey } from './crypto.js';
+import { registerDevice, heartbeatDevice, unregisterDevice } from './devices.js';
 import { promptApproval } from './prompt.js';
 import { touchRecentDir } from './recent-dirs.js';
 const HEARTBEAT_MS = 20_000;
@@ -17,9 +19,19 @@ function resolveShell() {
 }
 export async function startSession(options) {
     const { cb, memberId } = await requireClient();
-    const device = loadOrCreateDevice();
-    const deviceName = options.name ?? device.deviceName;
     const cwd = options.dir ? path.resolve(options.dir) : process.cwd();
+    // 폴더 이름을 기본 이름에 넣어서, 같은 컴퓨터에서 여러 개 띄워도 폰 목록에서 구분되게 한다.
+    const defaultName = cwd === os.homedir() ? os.hostname() : `${os.hostname()} · ${path.basename(cwd)}`;
+    const deviceName = options.name ?? defaultName;
+    // realtime userId 는 UUID 형태를 "인증된 멤버 전용"으로 취급해서 거부하므로, 세션 식별자는
+    // 접두사를 붙여 UUID 로 보이지 않게 만든다. `shellbase start` 를 실행할 때마다 새로 발급 —
+    // 예전엔 컴퓨터당 하나로 고정돼있어서, 같은 컴퓨터에서 두 개를 동시에 띄우면 프레임이 서로
+    // 섞였음(둘 다 같은 deviceId 를 썼기 때문). 이제 세션(프로세스)마다 독립된 식별자를 가짐.
+    const device = {
+        deviceId: `desktop-${crypto.randomUUID()}`,
+        deviceName,
+        frameKey: generateFrameKey(),
+    };
     console.log(`"${deviceName}" 세션을 시작해요 (작업 폴더: ${cwd})`);
     if (options.autoApprove) {
         console.log('⚠️  --auto-approve 켜짐 — 접속 요청을 묻지 않고 자동 승인해요. 내 계정에 들어올 수 있는 사람은 누구나 곧바로 입력할 수 있어요.');
@@ -136,10 +148,10 @@ export async function startSession(options) {
             // 이미 끊겼으면 무시
         }
         try {
-            await markDeviceOffline(cb, deviceRowId);
+            await unregisterDevice(cb, deviceRowId);
         }
         catch {
-            // 오프라인 표시 실패해도 종료는 계속 진행
+            // 삭제 실패해도 종료는 계속 진행 — 폰 목록에 남아있으면 나중에 수동으로 지울 수 있음
         }
         cb.realtime.disconnect();
         ptyProcess.kill();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shellbase",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "내 컴퓨터 터미널(특히 Claude Code 세션)을 폰 브라우저로 실시간 접속하게 해주는 데스크톱 에이전트",
   "type": "module",
   "bin": {