agentlas 0.5.2 → 0.5.5

package/engine/agentlas-doctor.cjs

@@ -20,12 +20,28 @@ function codexHome() {
   return process.env.CODEX_HOME || path.join(os.homedir(), ".codex");
 }
 
-/** 에러 텍스트에서 실패 원인으로 지목된 원격 호스트들을 추출한다. */
+/**
+ * 에러 텍스트에서 OAuth 자원 메타데이터로 명시된 호스트만 추출한다.
+ * stderr의 모든 URL을 수집하면 도움말·문서 링크와 관련된 정상 플러그인까지
+ * 수리 대상이 될 수 있다. 자동 수리는 구조화된 증거가 있을 때만 실행한다.
+ */
 function extractHosts(error) {
   const hosts = new Set();
-  const re = /https?:\/\/([a-z0-9][a-z0-9.-]*[a-z0-9])/gi;
-  let m;
-  while ((m = re.exec(error)) !== null) hosts.add(m[1].toLowerCase());
+  const addUrlHost = (rawUrl) => {
+    try {
+      hosts.add(new URL(rawUrl.replace(/[\]}>),.;]+$/g, "")).hostname.toLowerCase());
+    } catch {
+      /* 잘못된 메타데이터 URL은 자동 수리 증거로 쓰지 않음 */
+    }
+  };
+  const patterns = [
+    /resource_metadata(?:_url)?\s*[:=]\s*\\?["']?(https?:\/\/[^\s"'\\)>,]+)/gi,
+    /(https?:\/\/[^\s"'\\)>,]+\/\.well-known\/oauth-protected-resource(?:[/?#][^\s"'\\)>,]*)?)/gi,
+  ];
+  for (const re of patterns) {
+    let m;
+    while ((m = re.exec(error || "")) !== null) addUrlHost(m[1]);
+  }
   return [...hosts];
 }
 
@@ -47,7 +63,7 @@ function classifyFailure(error) {
     return { kind: "codex-config-invalid", hosts: [], badServer: extractBadMcpServer(text) };
   }
   if (/no response for \d+s|auto-aborted/i.test(text)) return { kind: "timeout", hosts: [] };
-  if (/CLI exit \d+|exited with code [1-9]/i.test(text)) return { kind: "cli-exit", hosts: extractHosts(text) };
+  if (/(?:CLI exit|exited with code)\s+[1-9]\d*/i.test(text)) return { kind: "cli-exit", hosts: extractHosts(text) };
   return { kind: "unknown", hosts: [] };
 }
 
@@ -89,7 +105,9 @@ function findOauthPluginsByHost(hosts) {
             } catch {
               continue;
             }
-            if (hosts.some((h) => h === host || h.endsWith("." + host) || host.endsWith("." + h))) {
+            // 호스트가 정확히 같을 때만 자동 수리한다. 부모/자식 도메인 관계만으로는
+            // 어느 플러그인이 실패했는지 증명할 수 없다.
+            if (hosts.includes(host)) {
               // cache 디렉토리 "openai-curated-remote"는 config 키에선 "openai-curated".
               hits.push({ pluginKey: `${plugin}@${marketplace.replace(/-remote$/, "")}`, host });
             }
@@ -111,12 +129,22 @@ function disableCodexPlugin(pluginKey) {
   const original = fs.readFileSync(configPath, "utf8");
   const header = `[plugins."${pluginKey}"]`;
   let next;
-  if (original.includes(header)) {
-    const idx = original.indexOf(header);
-    const after = original.slice(idx);
-    const replacedAfter = after.replace(/(\[plugins\."[^"]+"\]\s*\n)enabled\s*=\s*true/, "$1enabled = false");
-    if (replacedAfter === after) return false; // 이미 false거나 형태가 다름
-    next = original.slice(0, idx) + replacedAfter;
+  const escapeRegExp = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const headerMatch = new RegExp(`^[ \\t]*${escapeRegExp(header)}[ \\t]*(?:#.*)?\\r?$`, "m").exec(original);
+  if (headerMatch) {
+    const headerLineEnd = headerMatch.index + headerMatch[0].length;
+    const newlineIndex = original.indexOf("\n", headerLineEnd);
+    const bodyStart = newlineIndex === -1 ? original.length : newlineIndex + 1;
+    const remaining = original.slice(bodyStart);
+    const nextSection = /^[ \t]*\[[^\r\n]+\][ \t]*(?:#.*)?\r?$/m.exec(remaining);
+    const sectionEnd = nextSection ? bodyStart + nextSection.index : original.length;
+    const section = original.slice(headerMatch.index, sectionEnd);
+    const replacedSection = section.replace(
+      /^([ \t]*enabled[ \t]*=[ \t]*)true([ \t]*(?:#.*)?)(?=\r?$)/m,
+      "$1false$2",
+    );
+    if (replacedSection === section) return false; // 이미 false거나 해당 섹션에 enabled=true가 없음
+    next = original.slice(0, headerMatch.index) + replacedSection + original.slice(sectionEnd);
   } else {
     next = `${original.trimEnd()}\n\n${header}\nenabled = false\n`;
   }

package/engine/agentlas-i18n.cjs

@@ -16,6 +16,14 @@ const STRINGS = {
     "banner.help": "for commands",
     "banner.quit": "to quit",
     "banner.interrupt": "to interrupt",
+    "banner.product": "Agent OS terminal",
+    "banner.session": "%s · %s · %s",
+    "banner.location": "%s · / commands · Shift-Tab permissions",
+    "status.title": "Session",
+    "status.runtime": "runtime",
+    "status.agent": "agent",
+    "status.directory": "directory",
+    "status.permission": "permission",
     // picker
     "picker.agents": "Agents",
     "picker.companies": "Companies",
@@ -34,6 +42,15 @@ const STRINGS = {
     "stalled": "stream stalled — interrupted (idle timeout)",
     "thinkingWith": "thinking with %s",
     "spinnerStop": "ctrl-c to stop",
+    "runtime.thinking": "thinking…",
+    "runtime.reasoning": "reasoning…",
+    "runtime.starting": "starting %s…",
+    "runtime.failed": "failed to run %s: %s",
+    "runtime.exited": "%s exited with code %s",
+    "runtime.noOutput": "%s returned no output",
+    "runtime.rateLimit": "%s rate limit reached",
+    "runtime.doctor": "Runtime Doctor: %s",
+    "runtime.doctorRetry": "Repair complete — retrying the same request once.",
     "noKey": "No %s API key. Add one in the app (Settings → BYOK), or switch with /runtime.",
     "runtimeSet": "runtime → %s",
     "runtimeNotInstalled": "%s CLI is not installed.",
@@ -47,6 +64,10 @@ const STRINGS = {
     "permSet": "permission → %s",
     "permUsage": "usage: /permission read|write|full",
     "permCurrent": "current permission: %s",
+    "permCycleHint": "Shift-Tab to cycle",
+    "permCycleConfirm": "permission → %s",
+    "permFullArm": "FULL ACCESS IS UNRESTRICTED — press Shift-Tab again within 5 seconds to confirm",
+    "permFullConfirm": "FULL ACCESS ON FOR THIS SESSION — approvals and sandboxing are bypassed",
     "sideUsage": "usage: /side <question>",
     "sideNeedsSubject": "pick an agent first, or type the task normally so Agentlas can auto-route it",
     "sideStart": "side question; this answer will not be saved to chat context",
@@ -66,8 +87,10 @@ const STRINGS = {
     "market.loggedIn": "cloud session: signed in",
     "market.loggedOut": "cloud session: signed out — sign in via the app (or set AGENTLAS_SESSION) to install cloud agents",
     "mcp.none": "(no MCP servers configured — add them in the app)",
-    "mcp.wired": "%s server(s) wired into write/full turns (incl. playwright)",
-    "mcp.usage": "add/remove MCP servers in the app; the terminal wires enabled stdio servers",
+    "mcp.playwright": "Playwright browser",
+    "mcp.fullOnly": "full only",
+    "mcp.wired": "%s server(s) available only in full-access turns (incl. playwright)",
+    "mcp.usage": "add/remove MCP servers in the app; read/write never inject external MCP tools",
     "help.mcp": "list configured MCP servers and which are wired",
     "resume.title": "Resume — recent sessions",
     "resume.none": "(no saved sessions yet — they're saved after each turn)",
@@ -94,6 +117,13 @@ const STRINGS = {
     "multimodal.usage": "set with /multimodal set <image|video|audio> <provider-id>",
     // help rows
     "help.talk": "talk to the current agent/company — streaming + tools",
+    "help.help": "show commands, shortcuts, and common flows",
+    "help.title": "Help",
+    "help.intro": "Run local agents with explicit runtime, permission, files, shell, and history controls.",
+    "help.commands": "Commands",
+    "skills.title": "Skills",
+    "permissions.title": "Permissions",
+    "permissions.current": "Current",
     "help.skills": "list slash-command skills",
     "help.agents": "list installed agents",
     "help.team": "view/assign each agent's LLM (auto-routed by capability)",
@@ -114,7 +144,6 @@ const STRINGS = {
     "help.multimodal": "show/set image, video, and audio fallback providers",
     "help.import": "import a local folder (agent or team)",
     "help.market": "browse/install marketplace agents",
-    "help.install": "install a cloud agent by slug",
     "help.clear": "clear the chat and redraw",
     "help.storm": "run a force-robust Stormbreaker pipeline on a goal",
     "help.build": "build/repair/package an agent or team (Hephaestus)",
@@ -149,6 +178,31 @@ const STRINGS = {
     "help.tab": "autocomplete commands, agents, runtimes, paths",
     "help.arrows": "browse persisted input history",
     "help.ctrlc": "interrupt a running turn, or press twice when idle to quit",
+    "help.shiftTab": "cycle read → write → full permission",
+    "help.ctrlT": "show or hide the real runtime task/todo list during a turn",
+    "palette.title": "Slash commands",
+    "palette.search": "type to search",
+    "palette.category": "category: %s",
+    "palette.examples": "examples: %s",
+    "palette.controls": "↑↓ move · Enter run · Tab complete · Esc close",
+    "tasks.title": "Tasks",
+    "tasks.show": "Ctrl-T show",
+    "tasks.hide": "Ctrl-T hide",
+    "tasks.pending": "pending",
+    "tasks.progress": "in progress",
+    "tasks.done": "done",
+    "tasks.failed": "failed",
+    "category.Help": "Help",
+    "category.Session": "Session",
+    "category.Discovery": "Discovery",
+    "category.Knowledge": "Knowledge",
+    "category.Routing": "Routing",
+    "category.Settings": "Settings",
+    "category.Files": "Files",
+    "category.Context": "Context",
+    "category.Engine": "Engine",
+    "category.Hub": "Hub",
+    "category.Health": "Health",
     "compact.noop": "context is already compact (%s message(s))",
     "compact.done": "compacted context: %s → %s message(s)",
     // onboarding wizard
@@ -159,9 +213,9 @@ const STRINGS = {
     "wiz.runtimeInstalled": "installed",
     "wiz.runtimeMissing": "not installed",
     "wiz.permQ": "How much should agents be allowed to do by default?",
-    "wiz.permRead": "read — look only (no changes)",
-    "wiz.permWrite": "write — read + create/edit files (recommended)",
-    "wiz.permFull": "full — everything, including shell commands",
+    "wiz.permRead": "read — inspect only; runtime is read-only/plan",
+    "wiz.permWrite": "write — edit this workspace in the runtime sandbox; no external MCP (recommended)",
+    "wiz.permFull": "full — unrestricted; bypass runtime approvals and sandboxing",
     "wiz.pick": "Enter a number › ",
     "wiz.saved": "All set. You can change any of this later with /runtime, /permission.",
     "wiz.changeLang": "Tip: re-run setup anytime with  agentlas setup",
@@ -170,6 +224,14 @@ const STRINGS = {
     "banner.help": "명령 보기",
     "banner.quit": "종료",
     "banner.interrupt": "턴 중단",
+    "banner.product": "Agent OS 터미널",
+    "banner.session": "%s · %s · %s",
+    "banner.location": "%s · / 명령 · Shift-Tab 권한",
+    "status.title": "세션",
+    "status.runtime": "런타임",
+    "status.agent": "에이전트",
+    "status.directory": "작업 폴더",
+    "status.permission": "권한",
     "picker.agents": "에이전트",
     "picker.companies": "회사",
     "picker.none": "(아직 없음 — Agentlas 앱에서 에이전트를 설치하거나 /import <경로>)",
@@ -186,6 +248,15 @@ const STRINGS = {
     "stalled": "응답이 지연되어 중단했습니다 (idle timeout)",
     "thinkingWith": "%s로 생각 중",
     "spinnerStop": "ctrl-c로 중단",
+    "runtime.thinking": "생각 중…",
+    "runtime.reasoning": "추론 중…",
+    "runtime.starting": "%s 시작 중…",
+    "runtime.failed": "%s 실행 실패: %s",
+    "runtime.exited": "%s 종료 코드 %s",
+    "runtime.noOutput": "%s가 출력 없이 종료됨",
+    "runtime.rateLimit": "%s 사용량 한도에 도달함",
+    "runtime.doctor": "런타임 진단: %s",
+    "runtime.doctorRetry": "자동 수리 완료 — 같은 요청을 한 번 다시 시도합니다.",
     "noKey": "%s API 키가 없습니다. 앱 설정 → BYOK에서 등록하거나 /runtime으로 전환하세요.",
     "runtimeSet": "런타임 → %s",
     "runtimeNotInstalled": "%s CLI가 설치돼 있지 않습니다.",
@@ -199,6 +270,10 @@ const STRINGS = {
     "permSet": "권한 → %s",
     "permUsage": "사용법: /permission read|write|full",
     "permCurrent": "현재 권한: %s",
+    "permCycleHint": "Shift-Tab으로 변경",
+    "permCycleConfirm": "권한 → %s",
+    "permFullArm": "무제한 권한은 승인과 샌드박스를 우회합니다 — 5초 안에 Shift-Tab을 다시 눌러 확인",
+    "permFullConfirm": "이 세션에서만 무제한 권한 켜짐 — 승인과 샌드박스를 우회함",
     "sideUsage": "사용법: /side <질문>",
     "sideNeedsSubject": "먼저 에이전트를 고르거나, 그냥 할 일을 입력해서 Agentlas가 자동 라우팅하게 하세요.",
     "sideStart": "사이드 질문입니다. 이 답변은 메인 대화 맥락에 저장하지 않습니다.",
@@ -218,8 +293,10 @@ const STRINGS = {
     "market.loggedIn": "클라우드 세션: 로그인됨",
     "market.loggedOut": "클라우드 세션: 로그아웃 — 클라우드 설치는 앱에서 로그인(또는 AGENTLAS_SESSION) 필요",
     "mcp.none": "(설정된 MCP 서버 없음 — 앱에서 추가)",
-    "mcp.wired": "write/full 턴에 %s개 서버 연결됨 (playwright 포함)",
-    "mcp.usage": "MCP 서버 추가/삭제는 앱에서; 터미널은 enabled stdio 서버를 연결합니다",
+    "mcp.playwright": "Playwright 브라우저",
+    "mcp.fullOnly": "full 전용",
+    "mcp.wired": "무제한 권한 턴에서만 %s개 서버 사용 가능 (playwright 포함)",
+    "mcp.usage": "MCP 서버 추가/삭제는 앱에서; read/write에는 외부 MCP 도구를 주입하지 않음",
     "help.mcp": "설정된 MCP 서버와 연결 상태 보기",
     "resume.title": "이어하기 — 최근 세션",
     "resume.none": "(저장된 세션 없음 — 각 턴 후 저장됩니다)",
@@ -245,6 +322,13 @@ const STRINGS = {
     "multimodal.set": "멀티모달 %s → %s",
     "multimodal.usage": "/multimodal set <image|video|audio> <provider-id> 로 변경",
     "help.talk": "현재 에이전트/회사와 대화 — 스트리밍 + 툴",
+    "help.help": "명령·단축키·주요 사용법 보기",
+    "help.title": "도움말",
+    "help.intro": "런타임·권한·파일·셸·기록을 직접 통제하며 로컬 에이전트를 실행합니다.",
+    "help.commands": "명령",
+    "skills.title": "스킬",
+    "permissions.title": "권한",
+    "permissions.current": "현재",
     "help.skills": "slash 명령 스킬 목록",
     "help.agents": "설치된 에이전트 목록",
     "help.team": "에이전트별 LLM 보기/지정 (능력 기반 자동)",
@@ -265,7 +349,6 @@ const STRINGS = {
     "help.multimodal": "이미지·영상·음성 fallback provider 보기/변경",
     "help.import": "로컬 폴더(에이전트/팀) 임포트",
     "help.market": "마켓플레이스 에이전트 보기/설치",
-    "help.install": "slug로 클라우드 에이전트 설치",
     "help.clear": "대화 비우고 다시 그리기",
     "help.storm": "목표를 Stormbreaker 견고 파이프라인으로 실행",
     "help.build": "에이전트/팀 빌드·수리·패키징 (Hephaestus)",
@@ -299,6 +382,31 @@ const STRINGS = {
     "help.tab": "명령·에이전트·런타임·경로 자동완성",
     "help.arrows": "세션 간 저장된 입력 기록 탐색",
     "help.ctrlc": "실행 중인 턴 중단, 유휴 시 두 번 누르면 종료",
+    "help.shiftTab": "read → write → full 권한 순환",
+    "help.ctrlT": "실행 중 실제 런타임 작업 목록 열기/접기",
+    "palette.title": "슬래시 명령",
+    "palette.search": "입력해서 검색",
+    "palette.category": "분류: %s",
+    "palette.examples": "예시: %s",
+    "palette.controls": "↑↓ 이동 · Enter 실행 · Tab 완성 · Esc 닫기",
+    "tasks.title": "작업",
+    "tasks.show": "Ctrl-T 열기",
+    "tasks.hide": "Ctrl-T 접기",
+    "tasks.pending": "대기",
+    "tasks.progress": "진행 중",
+    "tasks.done": "완료",
+    "tasks.failed": "실패",
+    "category.Help": "도움말",
+    "category.Session": "세션",
+    "category.Discovery": "탐색",
+    "category.Knowledge": "지식",
+    "category.Routing": "라우팅",
+    "category.Settings": "설정",
+    "category.Files": "파일",
+    "category.Context": "맥락",
+    "category.Engine": "엔진",
+    "category.Hub": "허브",
+    "category.Health": "점검",
     "compact.noop": "이미 충분히 compact 상태입니다 (%s개 메시지)",
     "compact.done": "맥락 compact 완료: %s → %s개 메시지",
     "wiz.welcome": "Agentlas에 오신 걸 환영합니다 — 먼저 설정할게요.",
@@ -308,9 +416,9 @@ const STRINGS = {
     "wiz.runtimeInstalled": "설치됨",
     "wiz.runtimeMissing": "미설치",
     "wiz.permQ": "에이전트가 기본적으로 어디까지 할 수 있게 할까요?",
-    "wiz.permRead": "read — 보기만 (변경 없음)",
-    "wiz.permWrite": "write — 읽기 + 파일 생성/편집 (권장)",
-    "wiz.permFull": "full — 셸 명령 포함 전부",
+    "wiz.permRead": "read — 조회만; 런타임 read-only/plan",
+    "wiz.permWrite": "write — 런타임 샌드박스 안에서 작업 공간 편집; 외부 MCP 없음 (권장)",
+    "wiz.permFull": "full — 무제한; 런타임 승인과 샌드박스 우회",
     "wiz.pick": "번호 입력 › ",
     "wiz.saved": "완료. 나중에 /runtime, /permission으로 언제든 바꿀 수 있어요.",
     "wiz.changeLang": "팁: 언제든  agentlas setup  으로 다시 설정",

package/engine/agentlas-input.cjs

@@ -11,6 +11,7 @@ const fs = require("node:fs");
 const os = require("node:os");
 const path = require("node:path");
 const readline = require("node:readline");
+const i18n = require("./agentlas-i18n.cjs");
 
 function userDataDir() {
   const override = process.env.AGENTLAS_USER_DATA_DIR;
@@ -92,7 +93,7 @@ const SLASH_COMMAND_META = [
   { command: "/memory", description: "Show the memory injected into this run", category: "Context", usage: "/memory", detail: "Print the project memory that Agentlas adds to agent turns." },
   { command: "/side", description: "Ask a side question without saving it to chat context", category: "Context", usage: "/side <question>", detail: "Runs a one-off answer using current context, then returns without appending to chat history.", aliases: ["/btw"] },
   { command: "/multimodal", description: "Show or set image, video, and audio fallback providers", category: "Settings", usage: "/multimodal", detail: "Inspect or change fallback providers for media work." },
-  { command: "/mcp", description: "List configured MCP servers", category: "Settings", usage: "/mcp", detail: "Show MCP servers and which enabled stdio servers the terminal wires into write/full turns." },
+  { command: "/mcp", description: "List configured MCP servers", category: "Settings", usage: "/mcp", detail: "Show MCP servers available only during explicit full-access turns." },
   { command: "/diff", description: "Show the current git diff", category: "Files", usage: "/diff", detail: "Print the working-tree diff for the current cwd." },
   { command: "/history", description: "Show recent inputs", category: "Session", usage: "/history", detail: "Show persisted terminal input history." },
   { command: "/resume", description: "Resume a recent runtime session", category: "Session", usage: "/resume [n]", detail: "List recent agent/runtime sessions and continue one (restores the native session thread)." },
@@ -102,7 +103,6 @@ const SLASH_COMMAND_META = [
   { command: "/clear", description: "Clear the chat and redraw", category: "Session", usage: "/clear", detail: "Clear local conversation state and redraw the Agentlas banner." },
   { command: "/import", description: "Import a local agent or team folder", category: "Files", usage: "/import <path>", detail: "Install a local agent or team into Agentlas." },
   { command: "/marketplace", description: "Browse/install marketplace agents", category: "Routing", usage: "/marketplace", detail: "Show how to install agents from the Agentlas cloud marketplace or a local folder.", aliases: ["/market"] },
-  { command: "/install", description: "Install a cloud agent by slug", category: "Routing", usage: "/install <slug>", detail: "Download and install an agent from the Agentlas cloud marketplace by slug." },
   { command: "/storm", description: "Run a force-robust Stormbreaker pipeline on a goal", category: "Engine", usage: "/storm <goal> [--research]", detail: "Route the goal through Hephaestus Stormbreaker and execute the verified pipeline; --research grounds it with Research Engine evidence." },
   { command: "/swarm", description: "Fan out an emergent agent swarm on a goal", category: "Engine", usage: "/swarm <goal> [--parallel N]", detail: "Parallel workers share a blackboard and spawn subtasks with ## Spawn; a synthesizer merges results into one answer." },
   { command: "/build", description: "Build/repair/package an agent or team (Hephaestus)", category: "Engine", usage: "/build <what to build>", detail: "Runs Hephaestus hep-build natively — deep interview, scaffolding, packaging." },
@@ -120,19 +120,79 @@ const SLASH_COMMANDS = SLASH_COMMAND_META.flatMap((entry) => [entry.command].con
 const RUNTIME_SPECS = ["claude-code", "codex", "gemini", "anthropic", "openai", "google", "ollama", "upstage"];
 const PERM_LEVELS = ["read", "write", "full"];
 
+const HELP_KEY_BY_COMMAND = {
+  "/help": "help.help",
+  "/status": "help.status",
+  "/skills": "help.skills",
+  "/career-graph": "help.careerGraph",
+  "/ontology": "help.ontology",
+  "/agents": "help.agents",
+  "/team": "help.team",
+  "/agent": "help.agent",
+  "/firms": "help.firms",
+  "/firm": "help.firms",
+  "/runtime": "help.runtime",
+  "/model": "help.model",
+  "/effort": "help.effort",
+  "/permission": "help.permission",
+  "/permissions": "help.permissions",
+  "/setup": "help.setup",
+  "/cwd": "help.cwd",
+  "/memory": "help.memory",
+  "/side": "help.side",
+  "/multimodal": "help.multimodal",
+  "/mcp": "help.mcp",
+  "/diff": "help.diff",
+  "/history": "help.history",
+  "/resume": "help.resume",
+  "/compact": "help.compact",
+  "/cost": "help.cost",
+  "/keybindings": "help.keybindings",
+  "/clear": "help.clear",
+  "/import": "help.import",
+  "/marketplace": "help.market",
+  "/install": "help.install",
+  "/storm": "help.storm",
+  "/swarm": "help.swarm",
+  "/build": "help.build",
+  "/route": "help.route",
+  "/research": "help.research",
+  "/search": "help.search",
+  "/network": "help.network",
+  "/browser": "help.browser",
+  "/connect": "help.connect",
+  "/doctor": "help.doctor",
+  "/exit": "help.exit",
+};
+
 function uniqStartsWith(cands, token) {
   const hits = cands.filter((c) => c.startsWith(token));
   return hits.length ? hits : cands;
 }
 
-function slashCommandEntries() {
+function localizeSlashEntry(entry, lang) {
+  const helpKey = HELP_KEY_BY_COMMAND[entry.command];
+  const description = helpKey ? i18n.t(lang, helpKey) : entry.description;
+  const category = entry.category ? i18n.t(lang, `category.${entry.category}`) : entry.category;
+  return {
+    ...entry,
+    description,
+    category,
+    // English keeps the longer authored detail. Other languages must not fall back to
+    // an English paragraph under an otherwise-localized command palette.
+    detail: lang === "en" ? entry.detail : description,
+  };
+}
+
+function slashCommandEntries(lang = "en") {
   const rows = [];
-  for (const entry of SLASH_COMMAND_META) {
+  for (const rawEntry of SLASH_COMMAND_META) {
+    const entry = localizeSlashEntry(rawEntry, lang);
     rows.push({ ...entry, aliasOf: null });
     for (const alias of entry.aliases || []) {
       rows.push({
         command: alias,
-        description: `Alias for ${entry.command}`,
+        description: lang === "ko" ? `${entry.command} 별칭` : `Alias for ${entry.command}`,
         category: entry.category,
         usage: alias + (entry.usage && entry.usage.includes(" ") ? entry.usage.slice(entry.usage.indexOf(" ")) : ""),
         detail: entry.detail,
@@ -152,11 +212,11 @@ function slashCommandQuery(line) {
   return value;
 }
 
-function slashCommandSuggestions(line, limit = 12) {
+function slashCommandSuggestions(line, limit = 12, lang = "en") {
   const query = slashCommandQuery(line);
   if (query == null) return [];
   const q = query.toLowerCase();
-  const entries = slashCommandEntries();
+  const entries = slashCommandEntries(lang);
   const starts = entries.filter((entry) => entry.command.toLowerCase().startsWith(q));
   const contains = entries.filter(
     (entry) =>
@@ -167,9 +227,9 @@ function slashCommandSuggestions(line, limit = 12) {
 }
 
 function padVisible(value, width) {
-  const clean = stripAnsiLite(value);
-  if (clean.length >= width) return value;
-  return value + " ".repeat(width - clean.length);
+  const current = visibleWidthLite(value);
+  if (current >= width) return value;
+  return value + " ".repeat(width - current);
 }
 
 function stripAnsiLite(value) {
@@ -179,8 +239,40 @@ function stripAnsiLite(value) {
 
 function truncateVisible(value, width) {
   const clean = stripAnsiLite(value);
-  if (clean.length <= width) return value;
-  return clean.slice(0, Math.max(0, width - 1)) + "…";
+  if (visibleWidthLite(clean) <= width) return value;
+  let out = "";
+  let used = 0;
+  const room = Math.max(0, width - 1);
+  for (const ch of clean) {
+    const cells = cellWidthLite(ch);
+    if (used + cells > room) break;
+    out += ch;
+    used += cells;
+  }
+  return out + "…";
+}
+
+function cellWidthLite(ch) {
+  const cp = ch.codePointAt(0);
+  if (cp < 0x20) return 0;
+  return (
+    (cp >= 0x1100 && cp <= 0x115f) ||
+    (cp >= 0x2e80 && cp <= 0x303e) ||
+    (cp >= 0x3041 && cp <= 0x33ff) ||
+    (cp >= 0x3400 && cp <= 0x4dbf) ||
+    (cp >= 0x4e00 && cp <= 0x9fff) ||
+    (cp >= 0xac00 && cp <= 0xd7a3) ||
+    (cp >= 0xf900 && cp <= 0xfaff) ||
+    (cp >= 0xfe30 && cp <= 0xfe4f) ||
+    (cp >= 0xff00 && cp <= 0xff60) ||
+    (cp >= 0x1f300 && cp <= 0x1faff)
+  ) ? 2 : 1;
+}
+
+function visibleWidthLite(value) {
+  let width = 0;
+  for (const ch of stripAnsiLite(value)) width += cellWidthLite(ch);
+  return width;
 }
 
 function renderSlashPalette(rows, selectedIndex, opts = {}) {
@@ -194,32 +286,35 @@ function renderSlashPalette(rows, selectedIndex, opts = {}) {
     inverse: (s) => String(s),
   };
   const c = { ...fallbackColors, ...(opts.colors || {}) };
+  const lang = opts.lang || "en";
   const commandWidth = Math.min(24, Math.max(16, rows.reduce((n, row) => Math.max(n, row.command.length), 0) + 2));
   const descWidth = Math.max(12, columns - commandWidth - 8);
   const lineWidth = Math.min(columns - 1, commandWidth + descWidth + 5);
   const selected = rows[Math.max(0, Math.min(selectedIndex, rows.length - 1))] || rows[0];
   const out = [
-    c.faint("Slash commands") + c.dim("  type to search"),
+    c.faint(truncateVisible(`${i18n.t(lang, "palette.title")}  ${i18n.t(lang, "palette.search")}`, lineWidth)),
     c.faint("─".repeat(lineWidth)),
   ];
   rows.forEach((row, index) => {
     const command = padVisible(row.command, commandWidth);
     const desc = truncateVisible(row.description, descWidth);
     const body = " " + c.blue(command) + c.text(desc);
-    out.push(index === selectedIndex ? c.inverse(body.padEnd(lineWidth)) : body);
+    out.push(index === selectedIndex ? c.inverse(padVisible(body, lineWidth)) : body);
   });
   out.push(c.faint("─".repeat(lineWidth)));
   if (selected) {
     const usage = truncateVisible(selected.usage || selected.command, lineWidth - 2);
     const detail = truncateVisible(selected.detail || selected.description || "", lineWidth - 2);
-    const category = selected.category ? `category: ${selected.category}` : "";
-    out.push(" " + c.text(usage) + (category ? c.dim("  " + category) : ""));
+    const category = selected.category ? i18n.t(lang, "palette.category", selected.category) : "";
+    const categoryRoom = Math.max(0, lineWidth - visibleWidthLite(usage) - 3);
+    const categoryText = categoryRoom > 0 ? truncateVisible(category, categoryRoom) : "";
+    out.push(" " + c.text(usage) + (categoryText ? c.dim("  " + categoryText) : ""));
     if (detail) out.push(" " + c.dim(detail));
     if (selected.examples && selected.examples.length) {
-      out.push(" " + c.dim("examples: " + selected.examples.slice(0, 2).join("  |  ")));
+      out.push(c.dim(truncateVisible(" " + i18n.t(lang, "palette.examples", selected.examples.slice(0, 2).join("  |  ")), lineWidth)));
     }
   }
-  out.push(c.dim(" ↑↓ move  Enter run  Tab complete  Esc close"));
+  out.push(c.dim(truncateVisible(" " + i18n.t(lang, "palette.controls"), lineWidth)));
   return out.join("\n");
 }
 
@@ -244,7 +339,7 @@ function attachSlashPalette(rl, opts = {}) {
 
   function rows() {
     if (!state.enabled) return [];
-    return slashCommandSuggestions(rl.line || "");
+    return slashCommandSuggestions(rl.line || "", 12, opts.lang || (opts.ui && opts.ui.lang) || "en");
   }
   function active() {
     return rows().length > 0 && state.dismissedForLine !== (rl.line || "");
@@ -276,6 +371,7 @@ function attachSlashPalette(rl, opts = {}) {
     const body = renderSlashPalette(list, state.selected, {
       columns: stream.columns || process.stdout.columns || 88,
       colors,
+      lang: opts.lang || (opts.ui && opts.ui.lang) || "en",
     });
     stream.write("\x1b7\x1b[E\x1b[0J" + body + "\x1b8");
     state.visible = true;
@@ -365,6 +461,7 @@ function isAbsolutePathTask(line) {
   const value = String(line || "").trim();
   if (!value.startsWith("/")) return false;
   const first = value.split(/\s+/)[0] || "";
+  if (first === "/") return false;
   if (!first || SLASH_COMMANDS.includes(first)) return false;
   if (!path.isAbsolute(first)) return false;
   if (fs.existsSync(first)) return true;