eojeon-cli 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 All notable changes to this project are documented here. Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), versioning: [SemVer](https://semver.org/).
 
+## [0.3.0] - 2026-10-25
+
+### Added
+- `eojeon claude [claude flags…]`: run claude in your own terminal and mirror it into the running court. The web terminal shows the same screen (following that terminal's size), and web input and 윤허/불허 stamps go into it. Hooks are attached the same way as for the court's own claude. Without a running court it runs plain claude.
+
+### Changed
+- `server/pty.js` shares the claude lookup, node-pty loading and child environment between the server and `eojeon claude`.
+
 ## [0.2.0] - 2026-10-24
 
 Fixes from the first day of use.
@@ -35,5 +43,6 @@ First public version.
 - Hook payloads trimmed and secrets masked before leaving the hook process.
 - `scripts/check-publish.js` blocks publishing local paths, e-mail addresses or token-shaped strings.
 
+[0.3.0]: https://github.com/hiio420pr/eojeon/releases/tag/v0.3.0
 [0.2.0]: https://github.com/hiio420pr/eojeon/releases/tag/v0.2.0
 [0.1.0]: https://github.com/hiio420pr/eojeon/releases/tag/v0.1.0

package/README.md

@@ -61,6 +61,7 @@ npm start          # = node cli/eojeon.js
 | `--port <n>` | 포트 (기본 4747, 사용 중이면 다음 빈 포트) |
 | `--cwd <폴더>` | 시작 화면의 기본 작업 폴더 |
 | `--no-open` | 브라우저를 열지 않음 |
+| `eojeon claude [claude 옵션…]` | **내 터미널에서** claude 를 켜고 그 화면을 어전에 실시간으로 그대로 띄움. 웹에서 친 글자·윤허 도장도 이 터미널의 claude 로 들어감. 예: `eojeon claude --continue` |
 | `eojeon watch` / `eojeon watch --off` | 어전 밖(다른 터미널·IDE)에서 쓰는 Claude Code 도 화면에 보이게 / 끄기. 아래 '이미 쓰던 Claude Code 보기' |
 | `--host <주소>` | 다른 기기(Tailscale·같은 와이파이)에서 접속 허용. 접속 키 필요. 아래 '다른 기기에서 보기' |
 | `--new-key` | `--host` 와 함께: 접속 키 새로 만들기(예전 주소는 막힘) |
@@ -111,6 +112,19 @@ npm start          # = node cli/eojeon.js
 - 말풍선은 겹치지 않게 자리를 엇갈리고, 한 번에 3개까지만 보입니다. 나머지는 **사관 일지**(오른쪽)에 모두 남습니다.
 - **입력은 터미널 하나**: 컴퓨터에서는 아래 터미널에 바로 칩니다. 휴대폰·태블릿(터치 화면)에서만 터미널 아래에 **교지 쓰기** 칸이 보입니다(터치 키보드로 터미널에 한글을 치기 어려워서). Enter 하면 터미널에 그대로 들어갑니다.
 
+### 내 터미널을 어전에 그대로 (`eojeon claude`)
+
+어전 화면 안이 아니라 평소 쓰는 터미널에서 일하면서, 웹(다른 기기 포함)에도 **같은 CLI 화면과 궁궐 장면**이 실시간으로 보이게 합니다.
+
+```bash
+npx eojeon-cli                     # 어전을 켜 두고
+npx eojeon-cli claude --continue   # 다른 터미널에서 claude 대신 이렇게 실행 (claude 옵션은 그대로 넘어감)
+```
+
+- 웹 하단 터미널은 그 터미널의 화면을 그대로 보여 줍니다(크기도 그 터미널을 따름). 웹에서 입력하거나 윤허·불허 도장을 눌러도 그 claude 로 들어갑니다.
+- 어전이 꺼져 있으면 그냥 평범한 claude 로 실행됩니다.
+- 한 번에 하나만 연결됩니다. 어전 안에서 입궐한 claude 가 있으면 먼저 퇴청하세요.
+
 ### 이미 쓰던 Claude Code 보기 (`eojeon watch`)
 
 어전에서 띄운 claude 말고, 원래 쓰던 터미널·IDE 의 Claude Code 도 궁궐에 보이게 합니다.
@@ -214,6 +228,8 @@ claude plugin validate .
 2. **Claude Code plugin**: `/plugin marketplace add hiio420pr/eojeon` then `/plugin install eojeon@eojeon` (or on 2.1.275+: `/plugin install eojeon --marketplace hiio420pr/eojeon`). Then type `/eojeon` or "open the court". Third-party marketplaces don't auto-update by default: run `/plugin` → Marketplaces → eojeon → Enable auto-update (or `/plugin marketplace update eojeon`). You don't need both npx and the plugin. The plugin also provides the six agents as `eojeon:ijo` … `eojeon:gongjo`.
 3. **git clone**: `git clone https://github.com/hiio420pr/eojeon.git && cd eojeon && npm install && npm start`
 
+**Mirror your own terminal**: run `npx eojeon-cli claude [claude flags…]` (e.g. `--continue`) in any terminal while the court is running. The web shows that exact CLI screen live, and web input / permission stamps go into it. Without a running court it is plain claude.
+
 **Watch sessions you already run elsewhere**: `npx eojeon-cli watch` adds hooks to `~/.claude/settings.json` (backup kept) so any Claude Code session (other terminals, IDEs) shows up in the court while it runs — watch-only, answer its prompts in its own terminal. `eojeon watch --off` removes only our hooks.
 
 **Other devices (Tailscale, LAN)**: `npx eojeon-cli --host 0.0.0.0` (or just your Tailscale IP). Open the printed `http://<addr>:4747/?key=…` once; the device keeps a cookie for 30 days. No key, no access. Whoever has the key can use your claude terminal; rotate with `--new-key`. Without `--host` it stays on 127.0.0.1.

package/cli/eojeon.js

@@ -4,6 +4,7 @@
 //   eojeon demo [--port N]                      replay a scripted session, no claude needed
 //   eojeon init [DIR] [--pack yukjo|studio|all] copy subagent files into DIR/.claude/agents (never overwrites)
 //   eojeon watch [--off]                        also show Claude Code sessions running outside the court
+//   eojeon claude [claude args…]                run claude in this terminal, mirrored live into the court
 //   eojeon --help | --version
 import fs from 'node:fs';
 import path from 'node:path';
@@ -20,6 +21,9 @@ Usage
   eojeon demo [options]         Replay a scripted session (no claude, no usage)
   eojeon init [dir] [--pack P]  Add the Six Ministries (육조) subagents to dir/.claude/agents
                                 P = yukjo (default) | studio | all. Existing files are never overwritten.
+  eojeon claude [args…]         Run claude in THIS terminal, mirrored live into the running court:
+                                the web shows the same screen, and web input / 윤허 stamps reach it.
+                                Any claude flags pass through (e.g. eojeon claude --continue).
   eojeon watch [--off]          Also show Claude Code sessions you run elsewhere (any terminal or IDE),
                                 watch-only. Adds hooks to ~/.claude/settings.json (backup kept); --off removes them.
 
@@ -43,18 +47,26 @@ function takeOpt(list, name) {
   return v !== undefined && !v.startsWith('-') ? v : '';
 }
 
-if (argv.includes('-h') || argv.includes('--help') || argv[0] === 'help') {
+if (argv[0] !== 'claude' && (argv.includes('-h') || argv.includes('--help') || argv[0] === 'help')) {
   console.log(HELP);
   process.exit(0);
 }
-if (argv.includes('-v') || argv.includes('--version')) {
+if (argv[0] !== 'claude' && (argv.includes('-v') || argv.includes('--version'))) {
   console.log(pkg.version);
   process.exit(0);
 }
 
 const cmd = argv[0] && !argv[0].startsWith('-') ? argv.shift() : 'start';
 
-if (cmd === 'init') {
+if (cmd === 'claude') {
+  // everything after `claude` belongs to claude itself
+  const { run } = await import('../server/attach.js');
+  await run(process.argv.slice(process.argv.indexOf('claude') + 1));
+}
+
+if (cmd === 'claude') {
+  // handled above; keeps running until claude exits
+} else if (cmd === 'init') {
   const { install, PACKS } = await import('../server/agents.js');
   const pack = takeOpt(argv, '--pack') || 'yukjo';
   if (![...PACKS, 'all'].includes(pack)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eojeon-cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Claude Code as a Joseon royal court: issue a decree, AI officials (subagents) work, and ask for your royal assent. Pixel-art throne hall around your real Claude Code CLI. Unofficial. · Claude Code를 어전회의로 — 교지를 내리면 AI 신하들이 일하고 윤허를 청한다. 비공식 도구.",
   "keywords": [
     "claude-code",
@@ -41,7 +41,7 @@
     "start": "node cli/eojeon.js",
     "demo": "node cli/eojeon.js demo",
     "test": "node --test",
-    "check": "node --check cli/eojeon.js && node --check server/index.js && node --check server/hook.js && node --check server/sessions.js && node --check server/sanitize.js && node --check server/agents.js && node --check server/watch.js",
+    "check": "node --check cli/eojeon.js && node --check server/index.js && node --check server/hook.js && node --check server/sessions.js && node --check server/sanitize.js && node --check server/agents.js && node --check server/watch.js && node --check server/pty.js && node --check server/attach.js",
     "check-publish": "node scripts/check-publish.js",
     "prepublishOnly": "npm test && node scripts/check-publish.js",
     "postinstall": "node scripts/fix-pty.js",

package/public/app.js

@@ -47,12 +47,23 @@ let running = false;
 const send = (m) => ws && ws.readyState === 1 && ws.send(JSON.stringify(m));
 const sendInput = (d) => (DEMO ? null : send({ t: 'input', d }));
 
+// while another terminal is mirrored (eojeon claude), its size wins so the screen lines up
+let mirrorSize = null;
 function doFit() {
   try {
+    if (mirrorSize) {
+      term.resize(mirrorSize.cols, mirrorSize.rows);
+      return;
+    }
     fit.fit();
     send({ t: 'resize', cols: term.cols, rows: term.rows });
   } catch {}
 }
+function setMirror(size) {
+  mirrorSize = size || null;
+  $('term').classList.toggle('mirror', !!mirrorSize);
+  doFit();
+}
 new ResizeObserver(() => doFit()).observe($('term'));
 term.onData((d) => {
   sendInput(d);
@@ -109,7 +120,9 @@ let lastAsk = 0;
 function logLine(ev) {
   const who = titleOf(ev.agentType);
   switch (ev.type) {
-    case 'PtyStart': return ['sys', '·', `claude 를 띄웠습니다 · ${ev.folder} (${{ new: '새 조회', continue: '이어서', resume: '세션 이어받기' }[ev.mode] || ev.mode})`];
+    case 'PtyStart':
+      if (ev.mode === 'mirror') return ['sys', '⇄', `다른 터미널의 claude 가 연결됐습니다 · ${ev.folder}`];
+      return ['sys', '·', `claude 를 띄웠습니다 · ${ev.folder} (${{ new: '새 조회', continue: '이어서', resume: '세션 이어받기' }[ev.mode] || ev.mode})`];
     case 'PtyExit': return ['sys', '·', `claude 가 끝났습니다 (code ${ev.code})`];
     case 'SessionStart':
       if (ev.source === 'clear') return ['sys', '·', '조정을 새로 엽니다 (/clear)'];
@@ -349,7 +362,8 @@ function connect() {
     switch (msg.t) {
       case 'hello':
         running = msg.running;
-        setStatus(running ? 'running' : 'idle', running ? `진행 중 · ${msg.info?.folder || ''}` : '대기');
+        setMirror(msg.size);
+        setStatus(running ? 'running' : 'idle', running ? `${msg.size ? '다른 터미널 연결' : '진행 중'} · ${msg.info?.folder || ''}` : '대기');
         hint.classList.toggle('hidden', running);
         logEl.innerHTML = '';
         for (const ev of msg.history || []) onEvent(ev, { replay: true });
@@ -361,11 +375,20 @@ function connect() {
       case 'started':
         running = true;
         hint.classList.add('hidden');
-        setStatus('running', `진행 중 · ${msg.info.folder}`);
+        if (msg.size) {
+          term.reset();
+          court.reset();
+        }
+        setMirror(msg.size);
+        setStatus('running', `${msg.size ? '다른 터미널 연결' : '진행 중'} · ${msg.info.folder}`);
+        break;
+      case 'size':
+        setMirror({ cols: msg.cols, rows: msg.rows });
         break;
       case 'exit':
         running = false;
-        setStatus('idle', `끝남 (code ${msg.code})`);
+        setMirror(null);
+        setStatus('idle', msg.mirror ? '다른 터미널 연결 끝남' : `끝남 (code ${msg.code})`);
         term.write('\r\n\x1b[2m[claude 가 끝났습니다. 위에서 다시 입궐할 수 있습니다]\x1b[0m\r\n');
         break;
       case 'event':

package/public/index.html

@@ -55,7 +55,8 @@
       <div id="termHint" class="term-hint">
         <p id="termHintMain"><b>입궐</b>을 누르면 이 폴더에서 <code>claude</code> 가 뜹니다. 명령은 이 터미널에 바로 치세요.</p>
         <p class="muted">슬래시 명령·권한 창·/resume 이 모두 터미널 그대로 동작합니다.</p>
-        <p class="muted">이미 다른 터미널에서 쓰는 Claude Code 도 보려면: <code>npx eojeon-cli watch</code></p>
+        <p class="muted">내 터미널에서 쓰고 화면도 함께 보려면 그 터미널에서: <code>npx eojeon-cli claude</code> (예: <code>… claude --continue</code>)</p>
+        <p class="muted">이미 열린 Claude Code 의 움직임만 보려면: <code>npx eojeon-cli watch</code></p>
       </div>
       <form id="decreeForm" class="decree-bar" autocomplete="off">
         <label for="decreeInput" class="decree-label">교지 쓰기</label>

package/public/style.css

@@ -285,6 +285,8 @@ body { height: 100vh; }
 /* ---------- terminal ---------- */
 .term { flex: 1; min-height: 0; padding: 6px 0 0 8px; background: var(--paper); }
 .term .xterm { height: 100%; }
+.term.mirror { overflow: auto; }
+.term.mirror .xterm { height: auto; }
 .term-hint {
   position: absolute; inset: 0 0 46px 0; display: grid; place-content: center; text-align: center;
   color: var(--ink); pointer-events: none; font-size: 13px;

package/server/attach.js

@@ -0,0 +1,103 @@
+// `eojeon claude [claude args…]`: run claude in *this* terminal and mirror it into the running court.
+// The screen is copied to the browser as it is drawn, and whatever is typed in the browser
+// (or a 윤허/불허 stamp) goes into this claude too. Without a running court it is plain claude.
+import fs from 'node:fs';
+import path from 'node:path';
+import WebSocket from 'ws';
+import { runtimeFile } from './watch.js';
+import { findClaude, loadPty, childEnv } from './pty.js';
+
+function readRuntime() {
+  try {
+    const rt = JSON.parse(fs.readFileSync(runtimeFile(), 'utf8'));
+    process.kill(rt.pid, 0); // still alive?
+    return rt;
+  } catch {
+    return null;
+  }
+}
+
+function connect(rt, folder, cols, rows) {
+  return new Promise((resolve) => {
+    const ws = new WebSocket(`ws://127.0.0.1:${rt.port}/`, { headers: { origin: `http://127.0.0.1:${rt.port}` } });
+    const fail = (why) => {
+      try { ws.close(); } catch {}
+      resolve({ ws: null, why });
+    };
+    const timer = setTimeout(() => fail('timeout'), 3000);
+    ws.on('open', () => ws.send(JSON.stringify({ t: 'attach', token: rt.token, folder, cols, rows })));
+    ws.on('message', (raw) => {
+      let m;
+      try { m = JSON.parse(raw.toString()); } catch { return; }
+      if (m.t === 'attached') {
+        clearTimeout(timer);
+        resolve({ ws });
+      } else if (m.t === 'error') {
+        clearTimeout(timer);
+        fail(m.message);
+      }
+    });
+    ws.on('error', (e) => {
+      clearTimeout(timer);
+      fail(e.message);
+    });
+  });
+}
+
+export async function run(args) {
+  const claude = findClaude();
+  if (!claude) {
+    console.error('claude 를 찾지 못했습니다. Claude Code 를 먼저 설치하세요.');
+    process.exit(1);
+  }
+  const cwd = process.cwd();
+  let cols = process.stdout.columns || 100;
+  let rows = process.stdout.rows || 30;
+
+  const rt = readRuntime();
+  let ws = null;
+  if (rt) {
+    const r = await connect(rt, path.basename(cwd), cols, rows);
+    ws = r.ws;
+    if (!ws) console.error(`어전에 연결하지 못했습니다 (${r.why}). 그냥 claude 로 실행합니다.`);
+  } else {
+    console.error('어전이 꺼져 있습니다(npx eojeon-cli). 그냥 claude 로 실행합니다.');
+  }
+  const send = (m) => ws && ws.readyState === 1 && ws.send(JSON.stringify(m));
+
+  const claudeArgs = ws && rt.settings && fs.existsSync(rt.settings) ? ['--settings', rt.settings, ...args] : args;
+  const { spawn } = loadPty();
+  const pty = spawn(claude, claudeArgs, { name: 'xterm-256color', cols, rows, cwd, env: childEnv() });
+
+  pty.onData((d) => {
+    process.stdout.write(d);
+    send({ t: 'tout', d });
+  });
+  if (ws) {
+    ws.on('message', (raw) => {
+      let m;
+      try { m = JSON.parse(raw.toString()); } catch { return; }
+      if (m.t === 'input' && typeof m.d === 'string') pty.write(m.d);
+    });
+    ws.on('close', () => {
+      ws = null; // the court went away; keep working locally
+    });
+  }
+
+  if (process.stdin.isTTY) process.stdin.setRawMode(true);
+  process.stdin.setEncoding('utf8');
+  process.stdin.on('data', (d) => pty.write(d));
+  process.stdin.resume();
+  process.stdout.on('resize', () => {
+    cols = process.stdout.columns;
+    rows = process.stdout.rows;
+    try { pty.resize(cols, rows); } catch {}
+    send({ t: 'tsize', cols, rows });
+  });
+
+  pty.onExit(({ exitCode }) => {
+    if (process.stdin.isTTY) process.stdin.setRawMode(false);
+    try { ws?.close(); } catch {}
+    process.exit(exitCode ?? 0);
+  });
+}

package/server/index.js

@@ -16,6 +16,7 @@ import { listSessions } from './sessions.js';
 import { sanitize } from './sanitize.js';
 import { inspect as inspectAgents, install as installAgents, PACKS } from './agents.js';
 import { HOOK_EVENTS, eojeonDir, runtimeFile } from './watch.js';
+import { findClaude, loadPty, childEnv } from './pty.js';
 
 const require = createRequire(import.meta.url);
 const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
@@ -60,20 +61,6 @@ function expandHome(p) {
 }
 
 // ---------- claude binary ----------
-function findClaude() {
-  if (process.env.COURT_CLAUDE_BIN) return process.env.COURT_CLAUDE_BIN;
-  const names = process.platform === 'win32' ? ['claude.exe', 'claude.cmd', 'claude'] : ['claude'];
-  for (const dir of (process.env.PATH || '').split(path.delimiter)) {
-    for (const n of names) {
-      const p = path.join(dir, n);
-      try {
-        if (fs.statSync(p).isFile()) return p;
-      } catch {}
-    }
-  }
-  const local = path.join(os.homedir(), '.local', 'bin', 'claude');
-  return fs.existsSync(local) ? local : null;
-}
 const CLAUDE = findClaude();
 
 // ---------- temp settings with hooks ----------
@@ -95,7 +82,7 @@ function writeSettings(port) {
   // lets `eojeon watch` hooks (sessions outside the court) find this server
   try {
     fs.mkdirSync(eojeonDir(), { recursive: true, mode: 0o700 });
-    fs.writeFileSync(runtimeFile(), JSON.stringify({ port, token: TOKEN, pid: process.pid }), { mode: 0o600 });
+    fs.writeFileSync(runtimeFile(), JSON.stringify({ port, token: TOKEN, pid: process.pid, settings: settingsPath }), { mode: 0o600 });
   } catch {}
 }
 
@@ -111,6 +98,9 @@ function cleanup() {
 // ---------- state ----------
 let pty = null;
 let ptyInfo = null; // { cwd, mode, sessionId, startedAt }
+// `eojeon claude` in another terminal: its screen is mirrored here and web input goes back to it
+let mirror = null; // { ws, cols, rows }
+const isRunning = () => !!pty || !!mirror;
 let outBuf = '';
 const OUT_MAX = 256 * 1024;
 const events = [];
@@ -133,28 +123,6 @@ function sysEvent(type, extra = {}) {
   pushEvent({ type, time: Date.now(), ...extra });
 }
 
-// node-pty ships prebuilt binaries for macOS (arm64/x64) and Windows (x64/arm64).
-// On Linux the prebuilt fork @homebridge/node-pty-prebuilt-multiarch is used instead.
-// Both are optionalDependencies so `npx eojeon-cli` never fails to install (demo still works).
-const PTY_MODULES = ['node-pty', '@homebridge/node-pty-prebuilt-multiarch'];
-let ptyMod = null;
-function loadPty() {
-  if (ptyMod) return ptyMod;
-  const errors = [];
-  for (const name of PTY_MODULES) {
-    try {
-      ptyMod = require(name);
-      return ptyMod;
-    } catch (e) {
-      errors.push(`${name}: ${String(e.message).split('\n')[0]}`);
-    }
-  }
-  throw new Error(
-    '터미널 모듈(node-pty)을 불러오지 못했습니다. `npm i -g eojeon` 으로 다시 설치하거나 빌드 도구(python3, make, C++ 컴파일러)를 설치해 주세요. ' +
-      'Could not load node-pty. ' + errors.join(' | '),
-  );
-}
-
 // `claude --help` → --permission-mode choices. bypassPermissions is left out on purpose:
 // with it no petition ever reaches the court, and it skips every safety prompt.
 export const PERMISSION_MODES = ['manual', 'acceptEdits', 'plan', 'auto', 'dontAsk'];
@@ -164,6 +132,7 @@ function startClaude({ cwd, mode, sessionId, permissionMode }) {
   if (!CLAUDE) throw new Error('PATH 에서 claude 를 찾지 못했습니다. Claude Code 를 먼저 설치하세요.');
   const dir = path.resolve(expandHome(cwd || DEFAULT_CWD));
   if (!fs.existsSync(dir) || !fs.statSync(dir).isDirectory()) throw new Error(`폴더가 없습니다: ${dir}`);
+  if (mirror) throw new Error('다른 터미널의 claude(eojeon claude)가 연결돼 있습니다. 그 터미널에서 끝낸 뒤 입궐하세요.');
   stopClaude();
   const args = ['--settings', settingsPath];
   if (mode === 'continue') args.push('--continue');
@@ -178,16 +147,7 @@ function startClaude({ cwd, mode, sessionId, permissionMode }) {
     args.push('--permission-mode', permissionMode);
   }
 
-  const env = { ...process.env, TERM: 'xterm-256color', COLORTERM: 'truecolor', FORCE_COLOR: '1' };
-  // if this server itself was started from inside Claude Code, don't let the child think it's nested
-  // (session-scoped markers only; user config such as CLAUDE_CODE_USE_BEDROCK is kept)
-  for (const k of [
-    'CLAUDECODE', 'CLAUDE_CODE_ENTRYPOINT', 'CLAUDE_CODE_CHILD_SESSION', 'CLAUDE_CODE_SESSION_ID',
-    'CLAUDE_CODE_SESSION_ATTENDED', 'CLAUDE_CODE_SSE_PORT', 'CLAUDE_CODE_MESSAGING_SOCKET',
-    'CLAUDE_CODE_MESSAGING_TOKEN', 'CLAUDE_CODE_BRIDGE_SESSION_ID', 'CLAUDE_CODE_EXECPATH', 'CLAUDE_PID', 'CLAUDE_EFFORT',
-  ]) delete env[k];
-  for (const k of Object.keys(env)) if (k.startsWith('npm_')) delete env[k];
-  env.EOJEON_CHILD = '1'; // `eojeon watch` hooks skip this session (it already reports through --settings)
+  const env = childEnv();
 
   const { spawn } = loadPty();
   pty = spawn(CLAUDE, args, { name: 'xterm-256color', cols: size.cols, rows: size.rows, cwd: dir, env });
@@ -360,7 +320,7 @@ async function handle(req, res) {
   if (p === '/api/info') {
     return json(res, 200, {
       app: 'eojeon', version: VERSION,
-      demo: DEMO, defaultCwd: DEFAULT_CWD, claudeFound: !!CLAUDE, running: !!pty, info: ptyInfo,
+      demo: DEMO, defaultCwd: DEFAULT_CWD, claudeFound: !!CLAUDE, running: isRunning(), info: ptyInfo,
       home: os.homedir(), platform: process.platform, permissionModes: PERMISSION_MODES, remote: REMOTE,
     });
   }
@@ -422,18 +382,69 @@ function makeServer() {
 const server = makeServer();
 const WILDCARD = HOST === '0.0.0.0' || HOST === '::';
 
-wss.on('connection', (ws) => {
+function attachMirror(ws, m) {
+  if (pty) throw new Error('어전 안에서 claude 가 이미 돌고 있습니다. 화면에서 퇴청한 뒤 다시 시도하세요.');
+  if (mirror) throw new Error('다른 터미널이 이미 연결돼 있습니다.');
+  clients.delete(ws); // the mirror is a source, not a viewer
+  mirror = { ws, cols: Math.max(20, Math.min(400, m.cols | 0)), rows: Math.max(5, Math.min(200, m.rows | 0)) };
+  ptyInfo = { folder: String(m.folder || '').slice(0, 64), mode: 'mirror', startedAt: Date.now() };
+  outBuf = '';
+  ws.send(JSON.stringify({ t: 'attached' }));
+  broadcast({ t: 'started', info: ptyInfo, size: { cols: mirror.cols, rows: mirror.rows } });
+  sysEvent('PtyStart', { folder: ptyInfo.folder, mode: 'mirror' });
+  ws.on('close', () => {
+    if (mirror?.ws !== ws) return;
+    mirror = null;
+    broadcast({ t: 'exit', code: 0, mirror: true });
+    sysEvent('PtyExit', { code: 0 });
+  });
+}
+
+wss.on('connection', (ws, req) => {
   clients.add(ws);
-  ws.send(JSON.stringify({ t: 'hello', demo: DEMO, running: !!pty, info: ptyInfo, history: events.slice(-200) }));
-  if (pty && outBuf) ws.send(JSON.stringify({ t: 'out', d: outBuf, replay: true }));
+  ws.send(JSON.stringify({
+    t: 'hello', demo: DEMO, running: isRunning(), info: ptyInfo, history: events.slice(-200),
+    size: mirror ? { cols: mirror.cols, rows: mirror.rows } : null,
+  }));
+  if (isRunning() && outBuf) ws.send(JSON.stringify({ t: 'out', d: outBuf, replay: true }));
   ws.on('message', (raw) => {
     let m;
     try { m = JSON.parse(raw.toString()); } catch { return; }
+    // messages from the attached terminal itself
+    if (mirror && ws === mirror.ws) {
+      if (m.t === 'tout' && typeof m.d === 'string') {
+        outBuf += m.d;
+        if (outBuf.length > OUT_MAX) outBuf = outBuf.slice(outBuf.length - OUT_MAX);
+        broadcast({ t: 'out', d: m.d });
+      } else if (m.t === 'tsize') {
+        mirror.cols = Math.max(20, Math.min(400, m.cols | 0));
+        mirror.rows = Math.max(5, Math.min(200, m.rows | 0));
+        broadcast({ t: 'size', cols: mirror.cols, rows: mirror.rows });
+      }
+      return;
+    }
     switch (m.t) {
+      case 'attach':
+        // only a process on this computer that can read ~/.eojeon/runtime.json
+        if (!fromLoopback(req) || m.token !== TOKEN) {
+          ws.send(JSON.stringify({ t: 'error', message: 'attach refused' }));
+          ws.close();
+          break;
+        }
+        try {
+          attachMirror(ws, m);
+        } catch (e) {
+          ws.send(JSON.stringify({ t: 'error', message: e.message }));
+          ws.close();
+        }
+        break;
       case 'input':
-        if (pty && typeof m.d === 'string') pty.write(m.d);
+        if (typeof m.d !== 'string') break;
+        if (pty) pty.write(m.d);
+        else if (mirror && mirror.ws.readyState === 1) mirror.ws.send(JSON.stringify({ t: 'input', d: m.d }));
         break;
       case 'resize': {
+        if (mirror) break; // the other terminal decides the size
         const cols = Math.max(20, Math.min(400, m.cols | 0));
         const rows = Math.max(5, Math.min(200, m.rows | 0));
         size = { cols, rows };
@@ -448,7 +459,8 @@ wss.on('connection', (ws) => {
         }
         break;
       case 'stop':
-        stopClaude();
+        if (mirror) ws.send(JSON.stringify({ t: 'error', message: '연결된 터미널의 claude 는 그 터미널에서 끝내세요 (/exit).' }));
+        else stopClaude();
         break;
       default:
         break;

package/server/pty.js

@@ -0,0 +1,59 @@
+// Shared by the court server and `eojeon claude`: find the claude binary, load node-pty,
+// and build a clean environment for a claude child process.
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { createRequire } from 'node:module';
+
+const require = createRequire(import.meta.url);
+
+export function findClaude() {
+  if (process.env.COURT_CLAUDE_BIN) return process.env.COURT_CLAUDE_BIN;
+  const names = process.platform === 'win32' ? ['claude.exe', 'claude.cmd', 'claude'] : ['claude'];
+  for (const dir of (process.env.PATH || '').split(path.delimiter)) {
+    for (const n of names) {
+      const p = path.join(dir, n);
+      try {
+        if (fs.statSync(p).isFile()) return p;
+      } catch {}
+    }
+  }
+  const local = path.join(os.homedir(), '.local', 'bin', 'claude');
+  return fs.existsSync(local) ? local : null;
+}
+
+// node-pty ships prebuilt binaries for macOS (arm64/x64) and Windows (x64/arm64).
+// On Linux the prebuilt fork @homebridge/node-pty-prebuilt-multiarch is used instead.
+// Both are optionalDependencies so `npx eojeon-cli` never fails to install (demo still works).
+const PTY_MODULES = ['node-pty', '@homebridge/node-pty-prebuilt-multiarch'];
+let ptyMod = null;
+export function loadPty() {
+  if (ptyMod) return ptyMod;
+  const errors = [];
+  for (const name of PTY_MODULES) {
+    try {
+      ptyMod = require(name);
+      return ptyMod;
+    } catch (e) {
+      errors.push(`${name}: ${String(e.message).split('\n')[0]}`);
+    }
+  }
+  throw new Error(
+    '터미널 모듈(node-pty)을 불러오지 못했습니다. `npm i -g eojeon` 으로 다시 설치하거나 빌드 도구(python3, make, C++ 컴파일러)를 설치해 주세요. ' +
+      'Could not load node-pty. ' + errors.join(' | '),
+  );
+}
+
+export function childEnv() {
+  const env = { ...process.env, TERM: 'xterm-256color', COLORTERM: 'truecolor', FORCE_COLOR: '1' };
+  // if the court itself was started from inside Claude Code, don't let the child think it's nested
+  // (session-scoped markers only; user config such as CLAUDE_CODE_USE_BEDROCK is kept)
+  for (const k of [
+    'CLAUDECODE', 'CLAUDE_CODE_ENTRYPOINT', 'CLAUDE_CODE_CHILD_SESSION', 'CLAUDE_CODE_SESSION_ID',
+    'CLAUDE_CODE_SESSION_ATTENDED', 'CLAUDE_CODE_SSE_PORT', 'CLAUDE_CODE_MESSAGING_SOCKET',
+    'CLAUDE_CODE_MESSAGING_TOKEN', 'CLAUDE_CODE_BRIDGE_SESSION_ID', 'CLAUDE_CODE_EXECPATH', 'CLAUDE_PID', 'CLAUDE_EFFORT',
+  ]) delete env[k];
+  for (const k of Object.keys(env)) if (k.startsWith('npm_')) delete env[k];
+  env.EOJEON_CHILD = '1'; // `eojeon watch` hooks skip this session (it already reports through --settings)
+  return env;
+}