Main

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sorlros/detoks",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "private": false,
   "type": "module",
   "bin": {

src/cli/commands/repl.ts

@@ -440,6 +440,21 @@ const resolveReplMode = (args: CliArgs): ReplModeResolution => {
   return { useTui: false, reason: "non-TTY/CI 환경" };
 };
 
+const resolvePresentationMode = (
+  args: CliArgs,
+  replMode: ReplModeResolution,
+): CliArgs["presentationMode"] => {
+  if (args.presentationMode) {
+    return args.presentationMode;
+  }
+
+  if (replMode.useTui && args.executionMode === "real") {
+    return "embedded-pane";
+  }
+
+  return undefined;
+};
+
 export const runReplCommand = async (baseArgs: CliArgs): Promise<void> => {
   const executionCwd = baseArgs.cwd ?? process.cwd();
 
@@ -448,6 +463,7 @@ export const runReplCommand = async (baseArgs: CliArgs): Promise<void> => {
 
   // TUI 모드 판정
   const replMode = resolveReplMode(baseArgs);
+  const presentationMode = resolvePresentationMode(baseArgs, replMode);
 
   // TUI 모드인 경우: TUI REPL 실행
   if (replMode.useTui) {
@@ -468,7 +484,7 @@ export const runReplCommand = async (baseArgs: CliArgs): Promise<void> => {
         cwd: executionCwd,
         ...(baseArgs.sessionId ? { sessionId: baseArgs.sessionId } : {}),
         translationModel: getTranslationModel(),
-        ...(baseArgs.presentationMode ? { presentationMode: baseArgs.presentationMode } : {}),
+        ...(presentationMode ? { presentationMode } : {}),
       };
 
       if (currentModel) {

src/cli/parse.ts

@@ -256,8 +256,9 @@ const CLI_USAGE_REPL = [
   "  - 각 프롬프트는 별도의 작업 단위로 실행됩니다",
   "  - execution-mode는 프롬프트를 모의 실행으로 할지 실제 실행으로 할지 결정합니다",
   "  - interactive TTY에서는 기본적으로 TUI를 사용합니다. --no-tui로 legacy text REPL로 전환할 수 있습니다",
+  "  - real-mode TUI에서는 기본적으로 detoks TUI 안의 embedded CLI pane에 원본 CLI 출력을 표시합니다",
   "  - --passthrough-ui를 사용하면 원본 CLI UI를 먼저 보여주고 종료 후 detoks 요약을 표시합니다",
-  "  - --embedded-cli-ui를 사용하면 detoks TUI 안의 전용 패널에 원본 CLI 출력을 표시합니다",
+  "  - --embedded-cli-ui는 기본 embedded 동작을 명시적으로 고정합니다",
   "",
   "옵션:",
   `  --adapter ${ADAPTER_HELP}        대상 어댑터(기본값: codex)`,

tests/ts/unit/cli/repl-tui-startup.test.ts

@@ -83,6 +83,24 @@ describe("runReplCommand TUI startup flow", () => {
     );
   });
 
+  it("defaults real-mode TUI startup to embedded native presentation", async () => {
+    await runReplCommand({
+      mode: "repl",
+      adapter: "codex",
+      executionMode: "real",
+      verbose: false,
+      trace: false,
+      tui: "force",
+      showHelp: false,
+    });
+
+    expect(mocks.runTuiRepl).toHaveBeenCalledWith(
+      expect.objectContaining({
+        presentationMode: "embedded-pane",
+      }),
+    );
+  });
+
   it("passes embedded presentation mode into the TUI startup flow", async () => {
     await runReplCommand({
       mode: "repl",