@hncode/hncode 0.3.6 → 0.4.1

package/src/i18n.js

@@ -0,0 +1,389 @@
+// UI strings for the web interface — the ONE place they are defined.
+//
+// Both sides read this file: the browser imports it as a plain script (see
+// web-public/i18n.js, which is generated from this module so the two can never
+// drift), and the server uses it for the few strings it returns to the client
+// (error messages, the login page).
+// drift), and the server uses it for the few strings it returns to the client
+// (error messages, the login page).
+//
+// Adding a language: add a key to every entry in `MESSAGES`. A missing key falls
+// back to English at lookup time rather than printing the key, so a partly
+// translated language degrades readably instead of showing `nav.chat`.
+
+export const LANGUAGES = [
+  { id: 'zh', label: '中文' },
+  { id: 'en', label: 'English' },
+];
+
+// The WEB UI's default. The terminal never reads this file: TUI copy is English
+// by construction. A browser keeps its choice in localStorage (`hncode.lang`), so
+// this only decides the FIRST visit — and English is the safer default there,
+// since a link can be opened by anyone.
+export const DEFAULT_LANG = 'en';
+
+export const MESSAGES = {
+  // ---- document / login ----------------------------------------------------
+  'app.title': { zh: 'hncode', en: 'hncode' },
+  'login.heading': { zh: 'hncode', en: 'hncode' },
+  'login.lede': {
+    zh: '访问令牌保存在 config.toml 里，第一次运行时自动生成，之后一直不变。',
+    en: 'The access token lives in config.toml. It is generated once and stays the same.',
+  },
+  'login.tokenLabel': { zh: '访问令牌', en: 'Access token' },
+  'login.submit': { zh: '进入', en: 'Sign in' },
+  'login.badToken': { zh: '令牌不对。', en: 'Invalid token.' },
+  'login.failed': { zh: '登录失败。', en: 'Sign-in failed.' },
+  'login.unreachable': { zh: '连不上服务：', en: 'Cannot reach the server: ' },
+  'login.foot': {
+    zh: '本地服务，只监听回环地址。在任意一个终端里运行 /web 都能看到这台机器上的所有会话。',
+    en: 'Local service, loopback only. Run /web in any terminal to see every session on this machine.',
+  },
+
+  // ---- home (the session directory) ---------------------------------------
+  'home.brandSuffix': { zh: '会话', en: 'sessions' },
+  'home.lede': {
+    zh: '这台机器上的所有会话。运行中的可以继续对话，已退出的只能查看。',
+    en: 'Every session on this machine. Running ones accept input; exited ones are read-only.',
+  },
+  'home.empty': {
+    zh: '还没有任何会话。在终端里运行 hncode 开始一个。',
+    en: 'No sessions yet. Start one by running hncode in a terminal.',
+  },
+  'home.live': { zh: '运行中', en: 'Running' },
+  'home.saved': { zh: '已退出', en: 'Exited' },
+  'home.readonly': { zh: '只读', en: 'Read-only' },
+  'home.untitled': { zh: '未命名', en: 'Untitled' },
+  'home.noWorkspace': { zh: '未知目录', en: 'Unknown directory' },
+  'home.refresh': { zh: '刷新', en: 'Refresh' },
+  'home.logout': { zh: '退出登录', en: 'Sign out' },
+  'home.colTitle': { zh: '会话', en: 'Session' },
+  'home.colUpdated': { zh: '最后活动', en: 'Last active' },
+  'home.colRounds': { zh: '回合', en: 'Turns' },
+  'home.sessionCount': { zh: '{n} 个会话', en: '{n} session(s)' },
+  'home.loadFailed': { zh: '读取会话列表失败：', en: 'Could not load sessions: ' },
+  // Relative timestamps. They live in the table rather than as ternaries in the
+  // renderer so Chinese and English keep the same shape ("3 分钟前" / "3m ago"),
+  // and so both the landing page and the rail say it the same way.
+  'home.justNow': { zh: '刚刚', en: 'just now' },
+  'home.minutesAgo': { zh: '{n} 分钟前', en: '{n}m ago' },
+  'home.hoursAgo': { zh: '{n} 小时前', en: '{n}h ago' },
+  'home.daysAgo': { zh: '{n} 天前', en: '{n}d ago' },
+
+
+  // ---- navigation ----------------------------------------------------------
+  'nav.chat': { zh: '对话', en: 'Chat' },
+  'nav.readonly': { zh: '只读', en: 'read-only' },
+  'nav.ariaLabel': { zh: '视图切换', en: 'views' },
+  'rail.ariaLabel': { zh: '会话列表', en: 'sessions' },
+  'nav.tasks': { zh: '任务', en: 'Tasks' },
+  'nav.files': { zh: '文件', en: 'Files' },
+  'nav.logs': { zh: '日志', en: 'Logs' },
+  'nav.tools': { zh: '工具', en: 'Tools' },
+  'nav.commands': { zh: '命令', en: 'Commands' },
+  'nav.connecting': { zh: '连接中', en: 'Connecting' },
+  'nav.connected': { zh: '已连接', en: 'Connected' },
+  'nav.disconnected': { zh: '断开，重连中', en: 'Disconnected, retrying' },
+  'nav.language': { zh: '语言', en: 'Language' },
+
+  // ---- session rail --------------------------------------------------------
+  'rail.heading': { zh: '会话', en: 'Sessions' },
+  'rail.empty': { zh: '还没有其它会话', en: 'No other sessions' },
+  'rail.noMatch': { zh: '没有匹配的会话', en: 'No session matches' },
+  'rail.noWorkspace': { zh: '未知目录', en: 'Unknown directory' },
+  'rail.current': { zh: '当前', en: 'Current' },
+  'rail.search': { zh: '搜索 id / 标题 / 目录', en: 'search id / title / workspace' },
+  'rail.all': { zh: '所有会话', en: 'All sessions' },
+  'rail.open': { zh: '会话列表', en: 'Sessions' },
+  // ---- chat pane -----------------------------------------------------------
+'chat.untitled': { zh: '会话', en: 'Session' },
+  'chat.interrupt': { zh: '中断', en: 'Interrupt' },
+  'chat.placeholder': {
+    zh: '输入消息，Enter 发送，Shift+Enter 换行',
+    en: 'Message the agent. Enter sends, Shift+Enter adds a line',
+  },
+  'chat.send': { zh: '发送', en: 'Send' },
+  'chat.shellHint': { zh: '行首加 ! 直接执行命令', en: 'A leading ! runs the line in the shell' },
+  'chat.running': { zh: '运行中', en: 'Running' },
+  'chat.idle': { zh: '空闲', en: 'Idle' },
+  'chat.toggleHint': { zh: '点击展开原文', en: 'Click to expand' },
+
+  // ---- roles ---------------------------------------------------------------
+  'role.user': { zh: '你', en: 'You' },
+  'role.assistant': { zh: 'AI', en: 'AI' },
+  'role.tool': { zh: '工具', en: 'Tool' },
+  'role.toolResult': { zh: '输出', en: 'Output' },
+  'role.system': { zh: '系统', en: 'System' },
+  'role.warn': { zh: '警告', en: 'Warn' },
+  'role.thinking': { zh: '思考', en: 'Thinking' },
+  'role.shell': { zh: 'shell', en: 'shell' },
+  'role.plan': { zh: '计划', en: 'Plan' },
+  'role.compaction': { zh: '压缩', en: 'Compact' },
+  'role.aborted': { zh: '中止', en: 'Aborted' },
+  'role.bgTask': { zh: '任务', en: 'Task' },
+  'role.error': { zh: '错误', en: 'Error' },
+  'role.queued': { zh: '队列', en: 'Queued' },
+  'role.steer': { zh: '注入', en: 'Steer' },
+
+  // ---- tool states ---------------------------------------------------------
+  'tool.running': { zh: '运行中', en: 'running' },
+  'tool.done': { zh: '完成', en: 'done' },
+  'tool.failed': { zh: '失败', en: 'failed' },
+
+  // ---- compaction ----------------------------------------------------------
+  'compact.running': { zh: '正在压缩', en: 'Compacting' },
+  'compact.done': { zh: '压缩完成', en: 'Compaction complete' },
+  'compact.cancelled': { zh: '压缩取消', en: 'Compaction cancelled' },
+  // `before → after`. "tokens" is a noun here, not a bare unit, so it is a word to
+  // translate; `tok/s` elsewhere is a symbol and is not.
+  'compact.amount': { zh: '{before} → {after} tokens', en: '{before} → {after} tokens' },
+
+  // ---- tasks pane ----------------------------------------------------------
+  'tasks.heading': { zh: '后台任务', en: 'Background tasks' },
+  'tasks.refresh': { zh: '刷新', en: 'Refresh' },
+  'tasks.empty': { zh: '没有后台任务。', en: 'No background tasks.' },
+  'tasks.colId': { zh: 'ID', en: 'ID' },
+  'tasks.colKind': { zh: '类型', en: 'Kind' },
+  'tasks.colStatus': { zh: '状态', en: 'Status' },
+  'tasks.colSummary': { zh: '摘要', en: 'Summary' },
+  'tasks.stop': { zh: '停止', en: 'Stop' },
+
+  // ---- files pane ----------------------------------------------------------
+  'files.heading': { zh: '会话改动', en: 'Session changes' },
+  'files.sub': { zh: '本轮对话读写过的文件', en: 'Files this conversation read or wrote' },
+  'files.empty': { zh: '本会话还没有读写文件。', en: 'No files read or written yet.' },
+  'files.colPath': { zh: '路径', en: 'Path' },
+  'files.colOps': { zh: '操作', en: 'Ops' },
+  'files.colCount': { zh: '次数', en: 'Count' },
+
+  // ---- logs pane -----------------------------------------------------------
+  'logs.heading': { zh: '事件日志', en: 'Event log' },
+  'logs.clear': { zh: '清空', en: 'Clear' },
+  'logs.sub': { zh: '最近的会话事件，最新的在最下面', en: 'Recent session events, newest last' },
+
+  // ---- tools / commands panes ----------------------------------------------
+  'tools.heading': { zh: '可用工具', en: 'Tools available' },
+  'tools.sub': { zh: '由本会话的模型调用', en: 'Callable by the model in this session' },
+  'commands.heading': { zh: '斜杠命令', en: 'Slash commands' },
+  'commands.sub': { zh: '与终端完全一致', en: 'Identical to the terminal' },
+
+  // ---- status panel --------------------------------------------------------
+  'side.runtime': { zh: '运行', en: 'Runtime' },
+  'settings.open': { zh: '设置', en: 'Settings' },
+  'settings.title': { zh: '设置', en: 'Settings' },
+  'settings.close': { zh: '关闭', en: 'Close' },
+  'settings.save': { zh: '保存', en: 'Save' },
+  'settings.session': { zh: '会话', en: 'Session' },
+  'settings.titleLabel': { zh: '标题', en: 'Title' },
+  'settings.titleSaved': { zh: '标题已保存', en: 'Title saved' },
+  'settings.providers': { zh: 'Provider', en: 'Providers' },
+  'settings.noProviders': { zh: '还没有配置 provider', en: 'No providers configured' },
+  'settings.discover': { zh: '拉取模型', en: 'discover' },
+  'settings.foundModels': { zh: '找到 {n} 个模型', en: 'Found {n} model(s)' },
+  'settings.import': { zh: '导入', en: 'import' },
+  'settings.imported': { zh: '已导入 {name}，新增 {n} 个模型', en: 'Imported {name}, {n} new model(s)' },
+  'settings.importKnown': { zh: '从 models.dev 导入', en: 'Import from models.dev' },
+  'settings.keyPrompt': { zh: '请输入 {name} 的 API key：', en: 'API key for {name}:' },
+  'settings.addProvider': { zh: '添加', en: 'Add' },
+  'settings.added': { zh: '已添加 {name}', en: 'Added {name}' },
+  'settings.remove': { zh: '删除', en: 'remove' },
+  'settings.removed': { zh: '已删除 {name}', en: 'Removed {name}' },
+  'settings.confirmRemove': { zh: '删除 provider {name}？它的模型也会一并移除。', en: 'Delete provider {name}? Its models go too.' },
+  'settings.noMatch': { zh: '没有匹配项', en: 'No match' },
+  'settings.nameRequired': { zh: '名称不能为空', en: 'Name is required' },
+  'settings.failed': { zh: '操作失败：', en: 'Failed: ' },
+  'settings.prefs': { zh: '偏好', en: 'Preferences' },
+  'settings.info': { zh: '当前生效', en: 'In force' },
+  'settings.model': { zh: '模型', en: 'Model' },
+  'settings.provider': { zh: 'Provider', en: 'Provider' },
+  'settings.protocol': { zh: '协议', en: 'Protocol' },
+  'settings.endpoint': { zh: '端点', en: 'Endpoint' },
+  'settings.key': { zh: '密钥', en: 'API key' },
+  'settings.workspace': { zh: '目录', en: 'Workspace' },
+  'settings.ctx': { zh: '上下文窗口', en: 'Context window' },
+  // Placeholders for the "add provider" row and the models.dev filter.
+  'settings.phName': { zh: '名称', en: 'name' },
+  'settings.phUrl': { zh: '接口地址', en: 'base URL' },
+  'settings.phKey': { zh: 'API key', en: 'API key' },
+  'settings.phFilter': { zh: '筛选', en: 'filter' },
+  // Provider row tags / sub-line fragments.
+  'settings.tagKey': { zh: '已设密钥', en: 'key' },
+  'settings.tagNoKey': { zh: '无密钥', en: 'no key' },
+  'settings.noUrl': { zh: '未设置地址', en: '(no url)' },
+  'settings.modelCount': { zh: '{n} 个模型', en: '{n} model(s)' },
+  'settings.valSet': { zh: '已设置', en: 'set' },
+  'settings.valNotSet': { zh: '未设置', en: 'not set' },
+  'pref.calm': { zh: '简洁模式', en: 'Calm mode' },
+  'pref.autoCompact': { zh: '自动压缩', en: 'Auto compact' },
+  'pref.autoUpdate': { zh: '自动更新', en: 'Auto update' },
+  'pref.promptCache': { zh: '提示缓存', en: 'Prompt cache' },
+  'pref.external': { zh: '允许工作区外路径', en: 'Allow external paths' },
+
+  'side.model': { zh: '模型', en: 'Model' },
+  'side.provider': { zh: 'Provider', en: 'Provider' },
+  'side.mode': { zh: '权限', en: 'Permission' },
+  'side.cwd': { zh: '目录', en: 'Directory' },
+  'side.plan': { zh: '计划模式', en: 'Plan mode' },
+  'side.effort': { zh: '思考', en: 'Thinking' },
+  'side.focus': { zh: '专注模式', en: 'Focus mode' },
+  'side.busy': { zh: '状态', en: 'State' },
+  'side.context': { zh: '上下文', en: 'Context' },
+  'side.usage': { zh: '用量', en: 'Usage' },
+  'side.rounds': { zh: '轮次', en: 'Rounds' },
+  'side.steps': { zh: '步骤', en: 'Steps' },
+  'side.rate': { zh: '速度', en: 'Rate' },
+  // Unit suffixes for the values above. Chinese writes the unit straight after
+  // the number with no space (`3轮`), English needs one (`3 turns`) — so the
+  // separator belongs INSIDE the string rather than being concatenated at the
+  // call site. `tok/s` is a unit in both languages and is left as is.
+  'unit.rounds': { zh: '{n}轮', en: '{n} turns' },
+  'unit.steps': { zh: '{n}步', en: '{n} steps' },
+  'unit.rate': { zh: '{n} tok/s', en: '{n} tok/s' },
+  // The placeholder a card's field shows when it has no value at all. Distinct
+  // from `side.none` (「（无）」) which labels an EMPTY LIST in the rail; a field
+  // placeholder sits inline next to its label and is dimmed instead.
+  'unit.none': { zh: '—', en: '—' },
+  'side.todos': { zh: '待办', en: 'Todos' },
+  'side.queue': { zh: '队列', en: 'Queue' },
+  'side.quick': { zh: '快捷', en: 'Quick' },
+  'side.on': { zh: '开', en: 'on' },
+  'side.off': { zh: '关', en: 'off' },
+'side.none': { zh: '（无）', en: '(none)' },
+
+  // ---- queue pane ----------------------------------------------------------
+  // The terminal steers a queued message into the running turn with Ctrl-S; a
+  // browser cannot use that key, so each queued row carries its own button with
+  // the same effect.
+  // ---- copy / drawer / tool detail ------------------------------------------
+  // A copy button reports its own result in place: the label IS the feedback.
+  // ---- transcript markers ---------------------------------------------------
+  // The glyph the terminal prints in the gutter for each kind of row. They live
+  // here because the terminal and the browser must agree on them: a `❯` in the
+  // terminal and a `❯` in the browser are the same message.
+  'mark.user': { zh: '❯', en: '❯' },
+  'mark.queued': { zh: '❯', en: '❯' },
+  'mark.steer': { zh: '❯', en: '❯' },
+  'mark.bash': { zh: '!', en: '!' },
+  'mark.warn': { zh: '⚑', en: '⚑' },
+  'mark.thinking': { zh: '●', en: '●' },
+  'mark.tool': { zh: '●', en: '●' },
+  'mark.toolFailed': { zh: '✗', en: '✗' },
+  'mark.result': { zh: '↳', en: '↳' },
+  'mark.bgTask': { zh: '●', en: '●' },
+  'mark.bgTaskFailed': { zh: '✗', en: '✗' },
+
+  'tool.verb': { zh: '调用', en: 'Used' },
+  // The verb carries the STATE, as in the terminal: `Using …` while a call runs,
+  // `Used …` once it finished.
+  'tool.using': { zh: '调用', en: 'Using' },
+  'tool.used': { zh: '调用', en: 'Used' },
+  'chat.thinking': { zh: '思考…', en: 'thinking…' },
+  'tool.compacting': { zh: '正在压缩上下文…', en: 'Compacting context…' },
+  'tool.compacted': { zh: '压缩完成', en: 'Compaction complete' },
+  'tool.compactCancelled': { zh: '压缩取消', en: 'Compaction cancelled' },
+  // "show more" for a capped tool result. It is a button, so it says what
+  // clicking it does rather than describing a state.
+  'tool.moreLines': { zh: '还有 {n} 行，展开', en: '{n} more lines, expand' },
+  'tool.collapse': { zh: '收起', en: 'collapse' },
+  'tool.noChanges': { zh: '没有改动', en: 'no changes' },
+  'chat.shellMode': { zh: 'shell 模式，Enter 执行', en: 'shell mode, Enter runs it' },
+
+  // ---- status line ----------------------------------------------------------
+  // Same shape as the terminal's footer: `3 turns | 7 steps | 42 tok/s`. Kept in
+  // English on purpose — the terminal does not translate it either, and one
+  // person reading both screens should not see two different sentences.
+  'status.usage': {
+    zh: '{turns} 轮 | {steps} 步 | {rate} tok/s',
+    en: '{turns} turns | {steps} steps | {rate} tok/s',
+  },
+  'status.context': {
+    zh: '上下文 {pct}% ({used}/{max})',
+    en: 'context {pct}% ({used}/{max})',
+  },
+  'status.tasksBash': { zh: '[{n} 个任务运行中]', en: '[{n} task(s) running]' },
+  'status.tasksAgent': { zh: '[{n} 个 agent 运行中]', en: '[{n} agent(s) running]' },
+  'status.expandTodos': { zh: '展开全部待办', en: 'Show every todo' },
+
+  'copy.copy': { zh: '复制', en: 'copy' },
+  'copy.copyTitle': { zh: '复制到剪贴板', en: 'Copy to clipboard' },
+  'copy.done': { zh: '已复制', en: 'copied' },
+  'copy.failed': { zh: '复制失败', en: 'failed' },
+  'drawer.close': { zh: 'Esc 关闭', en: 'esc \u2715' },
+  'tool.args': { zh: '参数', en: 'args' },
+
+  'queue.steer': { zh: '注入', en: 'Steer' },
+  'queue.steering': { zh: '注入中…', en: 'Steering…' },
+  'queue.steerHint': { zh: '立即注入到正在进行的回合', en: 'Inject this into the running turn now' },
+  'queue.edit': { zh: '编辑', en: 'Edit' },
+  'queue.editHint': { zh: '取回输入框修改，不再排队', en: 'Pull it back into the composer to change it' },
+  'queue.drop': { zh: '移除', en: 'Drop' },
+  'queue.dropHint': { zh: '从队列中删除这条消息', en: 'Remove this message from the queue' },
+  'queue.moreHint': { zh: '… 还有 {n} 条', en: '… +{n} more' },
+  'queue.hintRunning': { zh: '等待本回合结束', en: 'Sent when this turn ends' },
+  'queue.hintIdle': { zh: '回合结束后依次发送', en: 'Sent in order once the turn ends' },
+
+  // ---- popover -------------------------------------------------------------
+  // The status line's values are buttons; these are the menu's own strings.
+'popover.click': { zh: '点击切换', en: 'Click to change' },
+  'popover.effortLabel': { zh: '思考等级', en: 'Thinking Effort' },
+  'popover.effort': { zh: '思考 {v}', en: 'think {v}' },
+  'popover.off': { zh: 'off', en: 'off' },
+  'popover.unknown': { zh: '—', en: '—' },
+
+
+
+  // NOTE: the bottom status line and context line are deliberately NOT translated.
+  // tui.js prints them as fixed English (`3 turns | 7 steps | 42 tok/s | context:
+  // 20% (…)`) with no i18n key, and these two rows exist to be the browser's copy
+  // of that readout. Translating one side would make the same person read two
+  // different sentences for the same state.
+
+  // ---- modal ---------------------------------------------------------------
+  // ---- modal ---------------------------------------------------------------
+  'modal.approve': { zh: '批准', en: 'Approve' },
+  'modal.reject': { zh: '拒绝', en: 'Reject' },
+  'modal.allow': { zh: '允许', en: 'Allow' },
+  'modal.deny': { zh: '拒绝', en: 'Deny' },
+  'modal.question': { zh: '需要选择', en: 'Question' },
+  'modal.submit': { zh: '提交', en: 'Submit' },
+  'modal.cancel': { zh: '取消', en: 'Cancel' },
+  'modal.other': { zh: 'Other', en: 'Other' },
+  'modal.otherHint': { zh: '自己输入答案', en: 'Type your own answer' },
+  'modal.note': { zh: '补充说明', en: 'Add a note' },
+  'modal.noteHint': { zh: '写给整轮问题的补充，可留空', en: 'Optional notes for the whole request' },
+  'modal.next': { zh: '下一题', en: 'Next' },
+  'modal.progress': { zh: '第 {n}/{total} 题', en: 'Question {n}/{total}' },
+
+  // ---- errors --------------------------------------------------------------
+  'err.actionFailed': { zh: '操作失败', en: 'Action failed' },
+  'err.unreachable': { zh: '连不上服务：', en: 'Cannot reach the server: ' },
+  'err.unauthorized': { zh: '未授权', en: 'Unauthorized' },
+  // Plain-text responses from the server itself (a direct visit, a curl call) —
+  // these have no page to carry a client-side language choice, so the server
+  // negotiates from Accept-Language.
+  'http.notFound': { zh: '找不到', en: 'not found' },
+  'http.badMethod': { zh: '不支持该请求方法', en: 'method not allowed' },
+  'http.unauthorized': { zh: '未授权', en: 'unauthorized' },
+};
+
+/**
+ * Look up one key. `lang` is a language id; anything unknown falls back to the
+ * default, then to English, then to the key itself (which makes a missing string
+ * obvious in situ instead of rendering as `undefined`).
+ */
+export function t(lang, key, vars) {
+  const entry = MESSAGES[key];
+  if (!entry) return key;
+  let s = entry[lang] || entry[DEFAULT_LANG] || entry.en || key;
+  if (vars) {
+    for (const k of Object.keys(vars)) s = s.split('{' + k + '}').join(String(vars[k]));
+  }
+  return s;
+}
+
+/** The whole table for one language, as a flat { key: string } map. */
+export function catalog(lang) {
+  const out = {};
+  for (const key of Object.keys(MESSAGES)) out[key] = t(lang, key);
+  return out;
+}

package/src/index.js

@@ -26,8 +26,8 @@ Options:
   -V, --version                 output the version number
   -S, --session [id]            Resume a session (with id) or pick interactively.
   -c, --continue                Continue the previous session for this directory.
-  -y, --yolo                    Routine edits/commands run; risky actions still ask.
-  --auto                        Never ask; everything runs automatically.
+  -y, --yolo                    Yolo mode: routine edits/commands run; risky actions still ask.
+  --auto                        Auto mode: never ask; everything runs automatically.
   -m, --model <model>           Model alias to use for this invocation.
   -p, --prompt <prompt>         Run one prompt non-interactively and print the reply.
   --output-format <format>      Prompt mode output: text (default), json, or stream-json.
@@ -35,6 +35,9 @@ Options:
                                 Exit code reflects the outcome: 0 ok, 1 failure, 2 config, 3 no answer, 4 interrupted.
   --control                     Expose a local control socket (prompt/status/interrupt) while the TUI runs.
   --control <path>              Same, at an explicit socket path.
+  --web                         Serve this session to a browser on 127.0.0.1 (random port).
+  --web [ip][:port]             Same, on a chosen address/port (e.g. --web 0.0.0.0:8080).
+  --plan                        Start in plan mode (research only, no writes).
   --plan                        Start in plan mode (research only, no writes).
   --add-dir <dir>               Add an additional workspace directory. Repeatable.
   -h, --help                    Show help.
@@ -66,7 +69,7 @@ export function parseArgs(argv) {
       if (eq >= 0) { key = a.slice(2, eq); val = a.slice(eq + 1); }
       else { key = a.slice(2); val = null; }
       if (key === 'resume') key = 'session'; // `--resume <id>` is an alias for `--session <id>`
-      if (['session', 'control'].includes(key) && val === null) { const nx = argv[i + 1]; out[key] = nx !== undefined && !nx.startsWith('-') ? (i++, nx) : true; }
+      if (['session', 'control', 'web'].includes(key) && val === null) { const nx = argv[i + 1]; out[key] = nx !== undefined && !nx.startsWith('-') ? (i++, nx) : true; }
 else if (key === 'model' || key === 'prompt' || key === 'output-format' || key === 'add-dir') {
         if (val === null) {
           const nx = argv[i + 1];
@@ -323,9 +326,44 @@ function loadOrCreateSession(opts, cfg) {
   return session;
 }
 
+
+/**
+ * Parse the --web flag into { bindIp, port } or null.
+ *   --web                  -> loopback, OS-assigned port
+ *   --web 8080             -> loopback, that port
+ *   --web 0.0.0.0:8080     -> explicit address and port
+ *   --web 192.168.1.5      -> that address, OS-assigned port
+ * Anything unparseable returns null, so the flag is ignored rather than failing
+ * the launch — /web from inside the session still works either way.
+ */
+export function parseWebArg(v) {
+  if (v == null || v === false) return null;
+  if (v === true) return { bindIp: '127.0.0.1', port: 0 };
+  const s = String(v).trim();
+  if (!s) return { bindIp: '127.0.0.1', port: 0 };
+  let bindIp = '127.0.0.1';
+  let port = 0;
+  if (/^\d+$/.test(s)) {
+    port = Number(s);
+  } else if (s.includes(':')) {
+    // IPv6 in brackets is deliberately not handled: /web covers it, and a
+    // half-parsed address is worse than ignoring the flag.
+    const at = s.lastIndexOf(':');
+    bindIp = s.slice(0, at) || '127.0.0.1';
+    const p = s.slice(at + 1);
+    if (!/^\d+$/.test(p)) return null;
+    port = Number(p);
+  } else {
+    bindIp = s;
+  }
+  if (port < 0 || port > 65535) return null;
+  return { bindIp, port };
+}
+
 export async function main(argv) {
   const args = parseArgs(argv);
   if (args.help) { printHelp(); return 0; }
+  if (args.help) { printHelp(); return 0; }
   if (args.version) { console.log(VERSION); return 0; }
 
   // subcommands
@@ -419,6 +457,11 @@ export async function main(argv) {
     // Remote control: expose a local socket so a script can queue a prompt or
     // query status on the running session (see ci.js).
     control: args.control === true ? '' : (typeof args.control === 'string' ? args.control : null),
+    // Web UI: start the server as soon as the TUI is up. `--web` alone binds
+    // loopback on an OS-assigned port; `--web 0.0.0.0:8080` chooses both. Parsed
+    // here so it behaves like every other flag, and the TUI still has /web to
+    // start or stop it mid-session.
+    web: parseWebArg(args.web),
     // MCP runs in the BACKGROUND once the TUI is up (see startTUI): connecting
     // can take seconds and must not delay the first paint.
     mcpConnect: connectMcp,