@miphamai/cli 0.19.5 → 0.20.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miphamai/cli",
-  "version": "0.19.5",
+  "version": "0.20.0",
   "description": "Mipham Code — Multi-model open-core intelligent coding terminal by MiphamAI",
   "keywords": [
     "ai",
@@ -55,6 +55,7 @@
     "@types/bun": "^1.3.14",
     "@types/node": "^22.19.19",
     "@types/react": "^18.3.29",
+    "ink-testing-library": "^4.0.0",
     "vitest": "^4.1.7"
   }
 }

package/src/core/engine.ts

@@ -18,6 +18,16 @@ import { getBackgroundAgentRegistry } from '../agent/background-registry'
 import { RulesLoader } from './rules-loader'
 import { UsageTracker } from './usage-tracker'
 import { buildRequest, sendInferenceCheck, isInferenceHookEnabled } from './inference-hook'
+import { createT } from '@mipham/shared/i18n/t'
+import enUS from '@mipham/shared/i18n/locales/en-US.json'
+import zhCN from '@mipham/shared/i18n/locales/zh-CN.json'
+import type { TranslationMap } from '@mipham/shared/i18n/types'
+
+const bundles: Record<string, TranslationMap> = {
+  'en-US': enUS as TranslationMap,
+  'zh-CN': zhCN as TranslationMap,
+}
+const t = createT(bundles['en-US'] || (enUS as TranslationMap), enUS as TranslationMap)
 
 export class QueryEngine {
   private hookEngine?: HookEngine
@@ -232,7 +242,7 @@ export class QueryEngine {
         // Return a minimal summary on failure
       }
 
-      return summary.slice(0, 8000) || 'Prior conversation context omitted.'
+      return summary.slice(0, 8000) || t('system.context.omitted')
     })
   }
 
@@ -257,7 +267,7 @@ export class QueryEngine {
       if (!submitResult.allowed) {
         yield {
           type: 'error',
-          error: submitResult.reason || 'User input blocked by hook.',
+          error: submitResult.reason || t('errors.user_input_blocked'),
         }
         return
       }
@@ -291,7 +301,7 @@ export class QueryEngine {
       if (!verdict.allowed) {
         yield {
           type: 'error',
-          error: verdict.reason || 'Request blocked by DLP policy.',
+          error: verdict.reason || t('errors.dlp_blocked'),
         }
         return
       }
@@ -316,7 +326,10 @@ export class QueryEngine {
         yield chunk
 
         if (chunk.type === 'error') {
-          this.context.addMessage({ role: 'assistant', content: `Error: ${chunk.error}` })
+          this.context.addMessage({
+            role: 'assistant',
+            content: t('errors.model_error', { error: chunk.error ?? 'Unknown error' }),
+          })
           return
         }
 
@@ -495,17 +508,26 @@ export class QueryEngine {
       if (this.goalVerifyScript) {
         const passed = await this.runScriptVerification()
         if (passed) {
-          yield { type: 'text', content: `✅ Goal verification passed: ${this.goalVerifyScript}` }
+          yield {
+            type: 'text',
+            content: t('system.goal.verified', { script: this.goalVerifyScript }),
+          }
           break
         }
         // Script failed — continue looping
-        yield { type: 'text', content: `🔄 Verification script failed — continuing (loop ${loop})` }
+        yield {
+            type: 'text',
+            content: t('system.goal.failed_continuing', { loop: String(loop) }),
+          }
         continue
       }
 
       // If using skill verification, delegate to the skill
       if (this.goalVerifySkill) {
-        yield { type: 'text', content: `🔍 Running verification skill: ${this.goalVerifySkill}` }
+        yield {
+          type: 'text',
+          content: t('system.goal.running_skill', { skill: this.goalVerifySkill }),
+        }
         yield* this.process(checkMsg, signal)
         if (this.lastAssistantContent?.includes('VERIFIED')) break
         continue
@@ -519,7 +541,7 @@ export class QueryEngine {
     if (loop >= this.maxGoalLoops) {
       yield {
         type: 'text',
-        content: `⚠ Max goal loops (${this.maxGoalLoops}) reached — goal may not be achieved.`,
+        content: t('system.goal.max_loops', { max: String(this.maxGoalLoops) }),
       }
     }
   }
@@ -571,7 +593,7 @@ export class QueryEngine {
         if (!verdict.allowed) {
           yield {
             type: 'error',
-            error: verdict.reason || 'Request blocked by DLP policy.',
+            error: verdict.reason || t('errors.dlp_blocked'),
           }
           return
         }
@@ -655,10 +677,10 @@ export class QueryEngine {
       if (turn === MAX_TURNS - 1 && toolUses.length > 0) {
         this.context.addMessage({
           role: 'user',
-          content:
-            `You've reached the maximum of ${MAX_TURNS} tool-calling rounds. ` +
-            `${toolUses.length} tool call(s) were not executed. ` +
-            'Please summarize what you found so far and any next steps the user should take.',
+          content: t('errors.max_tool_turns_warning', {
+            max: String(MAX_TURNS),
+            pending: String(toolUses.length),
+          }),
         })
         // Give model one final chance to respond with a summary
         try {
@@ -677,7 +699,7 @@ export class QueryEngine {
         } catch {
           yield {
             type: 'error',
-            error: `Max tool-calling turns (${MAX_TURNS}) reached. Some tool calls were not executed.`,
+            error: t('errors.max_tool_turns', { max: String(MAX_TURNS) }),
           }
         }
         return
@@ -730,7 +752,7 @@ export class QueryEngine {
       return {
         success: false,
         content: '',
-        error: `Tool "${name}" requires user approval (permission: ask). The tool was not executed.`,
+        error: t('errors.tool_not_allowed', { name }),
       }
     }
 
@@ -742,7 +764,7 @@ export class QueryEngine {
         return {
           success: false,
           content: '',
-          error: preResult.reason || `Tool "${name}" blocked by hook`,
+          error: preResult.reason || t('errors.tool_blocked', { name }),
         }
       }
       if (preResult.modifiedInput) {
@@ -803,7 +825,7 @@ export class QueryEngine {
   /** Register a tool dynamically (used by MCP auto-registration). */
   registerTool(tool: ToolDefinition): void {
     if (this.tools.has(tool.name)) {
-      process.stderr.write(`[mcp] Tool collision: "${tool.name}" already registered. Skipping.\n`)
+      process.stderr.write(t('errors.tool_collision', { name: tool.name }) + '\n')
       return
     }
     this.tools.set(tool.name, tool)
@@ -869,7 +891,9 @@ export class QueryEngine {
       // Feed the block reason back to the AI and continue
       this.context.addMessage({
         role: 'user',
-        content: `[The Stop hook blocked completion]: ${stopResult.reason || 'Continue working.'}`,
+        content: t('system.context.stop_blocked', {
+          reason: stopResult.reason || 'Continue working.',
+        }),
       })
       yield* this.continueWithTools(signal)
     }

package/src/i18n-context.tsx

@@ -0,0 +1,37 @@
+import React, { createContext, useContext } from 'react'
+import type { Locale } from '@mipham/shared/i18n/types'
+
+export interface I18nContextValue {
+  locale: Locale
+  t: (key: string, params?: Record<string, string>) => string
+}
+
+const I18nContext = createContext<I18nContextValue | null>(null)
+
+export function I18nProvider({
+  locale,
+  t,
+  children,
+}: {
+  locale: Locale
+  t: (key: string, params?: Record<string, string>) => string
+  children: React.ReactNode
+}) {
+  return React.createElement(
+    I18nContext.Provider,
+    { value: { locale, t } },
+    children,
+  )
+}
+
+export function useI18n(): I18nContextValue {
+  const ctx = useContext(I18nContext)
+  if (!ctx) {
+    // If no Provider is mounted (e.g., tests, bare scripts), return en-US no-op.
+    return {
+      locale: 'en-US',
+      t: (key: string) => key,
+    }
+  }
+  return ctx
+}

package/src/index.tsx

@@ -1,3 +1,4 @@
+import React from 'react'
 import { join } from 'node:path'
 import { existsSync } from 'node:fs'
 import { render } from 'ink'
@@ -23,6 +24,12 @@ import { getMetrics } from './core/metrics'
 import { ARTIFACTS_DIR, ARTIFACT_PORT, MIPHAM_DIR } from './shared/constants'
 import { AgentViewManager } from './agent-view/agent-view-manager'
 import { AgentViewDashboard } from './agent-view/dashboard'
+import { createT } from '@mipham/shared/i18n/t'
+import { detectLocale } from '@mipham/shared/i18n/detect'
+import { I18nProvider } from './i18n-context'
+import enUS from '@mipham/shared/i18n/locales/en-US.json' with { type: 'json' }
+import zhCN from '@mipham/shared/i18n/locales/zh-CN.json' with { type: 'json' }
+import type { TranslationMap } from '@mipham/shared/i18n/types'
 
 interface RunOptions {
   model?: string
@@ -60,6 +67,11 @@ export async function runApp(options: RunOptions): Promise<void> {
   // Load configuration
   const config = loadConfig()
 
+  // Detect locale and create translation function
+  const locale = detectLocale({ lang: options.lang })
+  const localeBundles: Record<string, TranslationMap> = { 'en-US': enUS as TranslationMap, 'zh-CN': zhCN as TranslationMap }
+  const t = createT(localeBundles[locale] || enUS, enUS)
+
   // Bootstrap providers
   const defaultProvider = options.provider || config.defaultProvider
   const defaultModel = options.model || config.defaultModel
@@ -297,17 +309,21 @@ export async function runApp(options: RunOptions): Promise<void> {
   })
 
   const { waitUntilExit } = render(
-    <App
-      engine={engine}
-      config={config}
-      initialProvider={defaultProvider}
-      initialModel={defaultModel}
-      lang={options.lang}
-      skillsLoader={skillsLoader}
-      pluginManager={pluginManager}
-      version={options.version}
-      sessionId={sessionName}
-    />,
+    React.createElement(I18nProvider, {
+      locale,
+      t,
+      children: React.createElement(App, {
+        engine,
+        config,
+        initialProvider: defaultProvider,
+        initialModel: defaultModel,
+        lang: options.lang,
+        skillsLoader,
+        pluginManager,
+        version: options.version,
+        sessionId: sessionName,
+      }),
+    }),
   )
   await waitUntilExit()
   saveAndExit()

package/src/mcp/client.ts

@@ -10,6 +10,16 @@ import { StdioTransport } from './transport'
 import { McpProtocol } from './protocol'
 import { OAuthClient } from './oauth'
 import { TokenStore } from './token-store'
+import { createT } from '@mipham/shared/i18n/t'
+import enUS from '@mipham/shared/i18n/locales/en-US.json'
+import zhCN from '@mipham/shared/i18n/locales/zh-CN.json'
+import type { TranslationMap } from '@mipham/shared/i18n/types'
+
+const bundles: Record<string, TranslationMap> = {
+  'en-US': enUS as TranslationMap,
+  'zh-CN': zhCN as TranslationMap,
+}
+const t = createT(bundles['en-US'] || (enUS as TranslationMap), enUS as TranslationMap)
 
 interface ActiveConnection {
   config: McpServerConfig
@@ -98,7 +108,7 @@ export class McpClient {
   /** Reconnect with exponential backoff (1s→2s→4s→…max 60s, 10 attempts). */
   async reconnect(name: string): Promise<void> {
     const connection = this.connections.get(name)
-    if (!connection) throw new Error(`No connection for "${name}"`)
+    if (!connection) throw new Error(t('errors.mcp_no_connection', { name }))
 
     const config = connection.config
     let delay = 1000
@@ -262,7 +272,7 @@ export class McpClient {
     const conn = this.connections.get(serverName)
     if (!conn || conn.status !== 'connected') {
       return {
-        content: [{ type: 'text', text: `Error: MCP server "${serverName}" not connected` }],
+        content: [{ type: 'text', text: t('errors.mcp_not_connected', { server: serverName }) }],
         isError: true,
       }
     }
@@ -271,7 +281,7 @@ export class McpClient {
       return await conn.protocol.callTool(toolName, params)
     } catch (err) {
       return {
-        content: [{ type: 'text', text: `MCP tool error: ${String(err)}` }],
+        content: [{ type: 'text', text: t('errors.mcp_tool_error', { error: String(err) }) }],
         isError: true,
       }
     }

package/src/mcp/oauth.ts

@@ -4,6 +4,16 @@ import { createServer, Server } from 'node:http'
 import type { IncomingMessage, ServerResponse } from 'node:http'
 import type { McpServerConfig } from '../shared/types'
 import { TokenStore } from './token-store'
+import { createT } from '@mipham/shared/i18n/t'
+import enUS from '@mipham/shared/i18n/locales/en-US.json'
+import zhCN from '@mipham/shared/i18n/locales/zh-CN.json'
+import type { TranslationMap } from '@mipham/shared/i18n/types'
+
+const bundles: Record<string, TranslationMap> = {
+  'en-US': enUS as TranslationMap,
+  'zh-CN': zhCN as TranslationMap,
+}
+const t = createT(bundles['en-US'] || (enUS as TranslationMap), enUS as TranslationMap)
 
 interface TokenResponse {
   accessToken: string
@@ -41,18 +51,18 @@ export class OAuthClient {
           if (receivedState !== state) {
             res.writeHead(400)
             res.end('State mismatch')
-            reject(new Error('OAuth state mismatch — possible CSRF'))
+            reject(new Error(t('errors.oauth_state_mismatch')))
             return
           }
           if (!receivedCode) {
             res.writeHead(400)
             res.end('No code received')
-            reject(new Error('No authorization code received'))
+            reject(new Error(t('errors.oauth_no_code')))
             return
           }
           res.writeHead(200, { 'Content-Type': 'text/html' })
           res.end(
-            '<html><body><h1>Authenticated</h1><p>You may close this window.</p></body></html>',
+            `<html><body><h1>${t('system.oauth.authenticated')}</h1><p>${t('system.oauth.close_window')}</p></body></html>`,
           )
           server.close()
           resolve(receivedCode)
@@ -81,7 +91,7 @@ export class OAuthClient {
       })
       setTimeout(() => {
         server.close()
-        reject(new Error('OAuth flow timed out (5 minutes)'))
+        reject(new Error(t('errors.oauth_timeout')))
       }, 300_000)
     })
 

package/src/mcp/registry.ts

@@ -9,6 +9,16 @@
 import type { ToolDefinition as McpToolDefinition, ToolCallResult } from './types'
 import type { ToolDefinition, ToolResult, ToolContext } from '../shared/types'
 import { McpClient } from './client'
+import { createT } from '@mipham/shared/i18n/t'
+import enUS from '@mipham/shared/i18n/locales/en-US.json'
+import zhCN from '@mipham/shared/i18n/locales/zh-CN.json'
+import type { TranslationMap } from '@mipham/shared/i18n/types'
+
+const bundles: Record<string, TranslationMap> = {
+  'en-US': enUS as TranslationMap,
+  'zh-CN': zhCN as TranslationMap,
+}
+const t = createT(bundles['en-US'] || (enUS as TranslationMap), enUS as TranslationMap)
 
 const MCP_TOOL_PREFIX = 'mcp__'
 const MAX_NAME_LENGTH = 128
@@ -108,7 +118,7 @@ export function registerMcpServerTools(
 
       if (toolsMap.has(tool.name)) {
         process.stderr.write(
-          `[mcp] Tool collision: "${tool.name}" (from server "${serverName}") conflicts with existing tool. Skipping.\n`,
+          t('errors.mcp_register_collision', { name: tool.name, server: serverName }) + '\n',
         )
         continue
       }
@@ -117,7 +127,7 @@ export function registerMcpServerTools(
       registered++
     } catch (err) {
       process.stderr.write(
-        `[mcp] Failed to register tool "${mcpTool.name}" from server "${serverName}": ${String(err)}\n`,
+        t('errors.mcp_register_failed', { tool: mcpTool.name, server: serverName, error: String(err) }) + '\n',
       )
     }
   }

package/src/tools/index.ts

@@ -1,5 +1,9 @@
 import type { ToolDefinition, ToolResult } from '../shared/index.ts'
 import { sanitizeParams } from '../shared/sanitize'
+import { createT } from '@mipham/shared/i18n/t'
+import enUS from '@mipham/shared/i18n/locales/en-US.json'
+import zhCN from '@mipham/shared/i18n/locales/zh-CN.json'
+import type { TranslationMap } from '@mipham/shared/i18n/types'
 import { readTool } from './file/read'
 import { writeTool } from './file/write'
 import { editTool } from './file/edit'
@@ -29,6 +33,12 @@ import { computerUseTool } from './computer/computer-use'
 import { scheduleWakeupTool } from './scheduling/schedule-wakeup.js'
 import { cronCreateTool, cronDeleteTool, cronListTool } from './scheduling/cron.js'
 
+const bundles: Record<string, TranslationMap> = {
+  'en-US': enUS as TranslationMap,
+  'zh-CN': zhCN as TranslationMap,
+}
+const t = createT(bundles['en-US'] || (enUS as TranslationMap), enUS as TranslationMap)
+
 /**
  * Validate tool parameters against the tool's JSON Schema definition.
  * Returns an array of error messages (empty = valid).
@@ -44,7 +54,7 @@ function validateParams(
   if (required) {
     for (const field of required) {
       if (params[field] === undefined || params[field] === null) {
-        errors.push(`Missing required parameter: "${field}"`)
+        errors.push(t('errors.missing_param', { param: field }))
       }
     }
   }
@@ -59,25 +69,25 @@ function validateParams(
 
       switch (def.type) {
         case 'string':
-          if (typeof value !== 'string') errors.push(`"${key}" must be a string`)
+          if (typeof value !== 'string') errors.push(t('errors.type_string', { key }))
           else if (def.enum && !def.enum.includes(value)) {
-            errors.push(`"${key}" must be one of: ${def.enum.join(', ')}`)
+            errors.push(t('errors.type_enum', { key, values: def.enum.join(', ') }))
           }
           break
         case 'integer':
         case 'number':
-          if (typeof value !== 'number') errors.push(`"${key}" must be a number`)
+          if (typeof value !== 'number') errors.push(t('errors.type_number', { key }))
           break
         case 'boolean':
-          if (typeof value !== 'boolean') errors.push(`"${key}" must be a boolean`)
+          if (typeof value !== 'boolean') errors.push(t('errors.type_boolean', { key }))
           break
         case 'object':
           if (typeof value !== 'object' || Array.isArray(value)) {
-            errors.push(`"${key}" must be an object`)
+            errors.push(t('errors.type_object', { key }))
           }
           break
         case 'array':
-          if (!Array.isArray(value)) errors.push(`"${key}" must be an array`)
+          if (!Array.isArray(value)) errors.push(t('errors.type_array', { key }))
           break
       }
     }
@@ -100,7 +110,7 @@ function withValidation(tool: ToolDefinition): ToolDefinition {
       const cleanParams = sanitizeParams(params)
       const errors = validateParams(schema, cleanParams)
       if (errors.length > 0) {
-        return { success: false, content: '', error: `Invalid parameters: ${errors.join('; ')}` }
+        return { success: false, content: '', error: t('errors.invalid_params', { errors: errors.join('; ') }) }
       }
       return tool.execute(cleanParams, ctx)
     },

package/src/ui/agent-footer.tsx

@@ -1,5 +1,6 @@
 import React from 'react'
 import { Box, Text } from 'ink'
+import { useI18n } from '../i18n-context'
 
 export interface AgentEntry {
   id: string
@@ -33,6 +34,7 @@ function formatTokens(n: number): string {
 }
 
 export function AgentFooter({ agents, gitBranch, tick: _tick }: AgentFooterProps) {
+  const { t } = useI18n()
   const hasAgents = agents.length > 0
   const hasBranch = gitBranch.length > 0
 
@@ -73,7 +75,7 @@ export function AgentFooter({ agents, gitBranch, tick: _tick }: AgentFooterProps
             {/* Spacer pushes stats to the right — Ink handles this naturally */}
             <Text dimColor>
               {'  '}
-              {isRunning ? formatElapsed(elapsed) : 'finished'}
+              {isRunning ? formatElapsed(elapsed) : t('ui.agent.finished')}
             </Text>
             {isRunning && agent.tokensUsed > 0 && (
               <Text dimColor>

package/src/ui/app.tsx

@@ -19,6 +19,7 @@ import {
   handleSwitch,
   type CommandContext,
 } from './commands'
+import { useI18n } from '../i18n-context'
 import type { PermissionMode } from '../shared/index.ts'
 
 interface AppProps {
@@ -72,14 +73,6 @@ const PERMISSION_MODES: PermissionMode[] = [
 // Labels aligned with Claude Code terminology: describe behavior, not capability.
 // Claude Code modes: manual mode → accept edits on → bypass
 // Mipham extends with 3 extra modes (plan, auto, dontAsk) for finer control.
-const PERMISSION_LABELS: Record<PermissionMode, string> = {
-  default: 'manual mode',
-  acceptEdits: 'accept edits on',
-  plan: 'plan mode · read-only',
-  auto: 'auto mode',
-  dontAsk: "don't ask",
-  bypassPermissions: 'bypass',
-}
 const PERMISSION_COLORS: Record<PermissionMode, string> = {
   default: 'white',
   acceptEdits: 'blue',
@@ -128,6 +121,18 @@ export function App({
   version,
   sessionId,
 }: AppProps) {
+  const { t } = useI18n()
+  const PERMISSION_LABELS = useMemo<Record<PermissionMode, string>>(
+    () => ({
+      default: t('ui.permission.manual'),
+      acceptEdits: t('ui.permission.accept_edits'),
+      plan: t('ui.permission.plan_mode'),
+      auto: t('ui.permission.auto'),
+      dontAsk: t('ui.permission.dont_ask'),
+      bypassPermissions: t('ui.permission.bypass'),
+    }),
+    [t],
+  )
   const [messages, setMessages] = useState<ChatMessage[]>([])
   const [isLoading, setIsLoading] = useState(false)
   const [providerId, setProviderId] = useState(initialProvider || config.defaultProvider)
@@ -244,8 +249,9 @@ export function App({
       setUltracodeMode: (on: boolean) => setUltracodeMode(on),
       skillsLoader,
       pluginManager,
+      t,
     }),
-    [engine, config, providerId, modelId, skillsLoader, pluginManager, sessionId],
+    [engine, config, providerId, modelId, skillsLoader, pluginManager, sessionId, t],
   )
 
   const handleSubmit = useCallback(
@@ -612,10 +618,10 @@ export function App({
         )}
         <Box flexDirection="row">
           <Text color={PERMISSION_COLORS[permissionMode]}>
-            ⏵⏵ {PERMISSION_LABELS[permissionMode]} (shift+tab to cycle)
+            ⏵⏵ {PERMISSION_LABELS[permissionMode]} ({t('ui.status.shift_tab_cycle')})
           </Text>
-          <Text dimColor> · esc to interrupt</Text>
-          <Text dimColor> · ← for agents</Text>
+          <Text dimColor> · {t('ui.status.esc_to_interrupt')}</Text>
+          <Text dimColor> · {t('ui.status.left_for_agents')}</Text>
         </Box>
       </Box>
     </Box>

package/src/ui/chat.tsx

@@ -1,5 +1,6 @@
 import React from 'react'
 import { Box, Text } from 'ink'
+import { useI18n } from '../i18n-context'
 import type { ChatMessage } from './app'
 
 interface ChatPanelProps {
@@ -49,6 +50,7 @@ function toolColor(name: string): string {
  */
 const MessageRow = React.memo(
   function MessageRow({ msg }: { msg: ChatMessage; isLast: boolean }) {
+    const { t } = useI18n()
     return (
       <Box
         flexDirection="column"
@@ -76,8 +78,8 @@ const MessageRow = React.memo(
               {msg.role === 'user'
                 ? `▸ ${displayCwd()}`
                 : msg.role === 'assistant'
-                  ? 'Mipham Code'
-                  : '⚠ System'}
+                  ? t('ui.assistant.role_label')
+                  : `⚠ ${t('ui.system.role_label')}`}
               :
             </Text>
             <Text>{msg.content}</Text>
@@ -93,6 +95,7 @@ const MessageRow = React.memo(
 )
 
 export function ChatPanel({ messages, focusMode }: ChatPanelProps) {
+  const { t } = useI18n()
   // Group consecutive tool calls into compact summaries to reduce visual noise.
   // In focus mode, use the more aggressive compactForFocus.
   const displayMessages = focusMode ? compactForFocus(messages) : compactToolGroups(messages)
@@ -102,8 +105,7 @@ export function ChatPanel({ messages, focusMode }: ChatPanelProps) {
       {focusMode && messages.length > 0 && (
         <Box marginBottom={1}>
           <Text dimColor>
-            🔍 Focus — {countHidden(messages, displayMessages)} hidden · /focus to toggle · Ctrl+O
-            to expand
+            🔍 {t('ui.chat.focus_hint')} — {countHidden(messages, displayMessages, t)} · {t('ui.chat.toggle_focus_hint')} · {t('ui.chat.expand_hint')}
           </Text>
         </Box>
       )}
@@ -111,22 +113,24 @@ export function ChatPanel({ messages, focusMode }: ChatPanelProps) {
         <Box flexDirection="column">
           <Box marginBottom={1}>
             <Text color="cyan" bold>
-              Mipham Code
+              {t('ui.banner.title')}
             </Text>
-            <Text dimColor> — AI-Powered Programming Assistant</Text>
+            <Text dimColor> — {t('ui.banner.subtitle')}</Text>
           </Box>
-          <Text dimColor>Multi-model · Multi-provider · Skills & Tools · Open-core</Text>
+          <Text dimColor>{t('ui.banner.tagline')}</Text>
           <Box marginTop={1}>
             <Text dimColor>
-              Type a message to start. <Text color="yellow">/help</Text> for commands ·{' '}
-              <Text color="yellow">Ctrl+P</Text> pick model · <Text color="yellow">Esc</Text> to
-              exit
+              {t('ui.banner.start_message')} <Text color="yellow">/help</Text>
             </Text>
           </Box>
           <Box marginTop={1}>
             <Text dimColor>
-              Tip: Use <Text color="yellow">/clear</Text> to start fresh when switching topics and
-              free up context
+              {t('ui.banner.controls_hint')}
+            </Text>
+          </Box>
+          <Box marginTop={1}>
+            <Text dimColor>
+              {t('ui.banner.tip_clear')}
             </Text>
           </Box>
         </Box>
@@ -239,9 +243,9 @@ function summarizeToolGroup(tools: ChatMessage[]): ChatMessage {
 }
 
 /** Count how many messages are hidden in focus mode. */
-function countHidden(all: ChatMessage[], compacted: ChatMessage[]): string {
+function countHidden(all: ChatMessage[], compacted: ChatMessage[], t: (key: string, params?: Record<string, string>) => string): string {
   const toolCount = all.filter((m) => m.toolMeta).length
   const hidden = all.length - compacted.length
-  if (hidden <= 0) return `showing all ${all.length} messages`
-  return `${hidden} tool outputs folded (${toolCount} total tool calls)`
+  if (hidden <= 0) return t('ui.chat.showing_all', { count: String(all.length) })
+  return t('ui.chat.tool_outputs_folded', { hidden: String(hidden), toolCount: String(toolCount) })
 }