RFC · CLI / TUI design + interaction — what works, what is missing, what would you change?

[esengine]

Reasonix's primary surface is the terminal. The card-stream redesign shipped in 0.18, and the design anchor lives at design/agent-tui-terminal.html — open it in a browser, it's a static HTML "screenshot" of the intended look + every interaction state.

Want your input on:

• What is broken for you on a given platform / terminal — Win10 cmd, mosh, tmux, iTerm, ConPTY, WSL, Termux, …
• What feels slow — keystroke latency, scroll lag, dropped frames, repaint glitches
• What is missing — keys you reach for that aren't bound; common flows that take too many steps
• What is over-engineered — features you wish weren't there
• What is new — interaction ideas you have'nt seen elsewhere

A few anchors to react against:

1. Slash commands — current set is at src/cli/ui/slash/commands.ts. Should anything be promoted to a key chord? Removed? Added?
2. Keystroke vocabulary — ↵ send · ⇧↵ newline · Esc abort/close · ↑↓ history · ⌘K palette. Anything you reach for that fails?
3. Approval modals (shell / plan / edit) — explicit y / a / n (approve / always / deny). Friction or feature?
4. Status row — tools 23 · mcp 2 · last event 12s. Useful or noise? What would you put there instead?
5. Card density — full streaming + tool calls inline. Too much, too little?
6. Session lifecycle — --new preserves the old, --resume finds the latest. Right defaults?

Not asking for polished proposals — half-baked is welcome. Code references / screenshots / asciicasts all useful.

Replies in English or 中文 都行.

[lamyc]

Really nice work on this project. The DeepSeek‑specific optimizations (Cache‑First Loop, R1 Thought Harvesting, Tool‑Call Repair) are really smart.

I just started unboxing and testing it.

🐛 Bug / Broken

• The TUI sometimes glitches
  . I'm not 100% sure what triggers it, but it might be related to resizing the terminal window. (I’m on Linux Mint + WezTerm, SSH to Ubuntu.)

✨ Feature improvements

1. Portrait monitor layout – When running on a secondary vertical screen, the current TUI gets very crowded. It would help a lot if the task/to‑do list could be collapsed into a sidebar (toggleable, like opencode does).
2. Model response readability – A background highlight on responses (instead of just text color) would make long replies much easier to follow.
3. Prompt input shortcuts – Support for <Home> / <End> (cursor jump to line start/end) and common CLI shortcuts like Ctrl+U (clear from cursor to beginning of line) would make the input feel far more natural for terminal users.

I know both bug fixes (especially layout/repaint issues) and adding shortcuts / UI changes are non‑trivial. Totally understand the effort involved.

Huge thanks to the author for sharing this work. Much appreciated.

[esengine]

Thanks — really useful report.

The glitch isn't actually resize: the trigger is the approval modal anchored at the bottom while a tool card (write_file in your video) is still streaming at the top. The bottom-anchor layer and the growing-card layer fight for the same rows. I've spotted a few variants of this — sweeping them in #120.

Home / End / Ctrl+U will land in the next patch — tracked in #121. Portrait sidebar + assistant background highlight in #122.

[bitons]

1.windows 11第一次安装后，在powershell中启动，会让你选择5个mcp，但是当我没有选择file system也就是文件操作的mcp，第二次启动就不知道去哪里安装或者启动。只能重装

虽然这个软件能够检测系统语言并切换为中文，但是一些内容上更加本地化对于初次体验终端AI的人来说体验会更好
2.mcp市场里的条目太多，而且无论是标题还是描述并没有中文。
3.可以考虑一下把部分斜杠命令也写成中文吗，这样就不用总看后面的说明了。

4.在设定工作文件夹后，切换文件夹的方式可以简化以下吗？我在文件夹B内使用右键菜单“在终端中打开”，并使用reasonix命令，但是提问后发现还是第一次设定的那个文件夹A。

5.不知为何不能使用项目介绍中的命令更改工作文件夹，而是：npx reasonix code D:\Documents\code才可以

[esengine]

Thanks for the detailed feedback - concrete points below.

1. Stuck after skipping filesystem MCP at setup. Re-running the wizard already works: reasonix setup walks the same flow and overwrites the selection - no reinstall needed. reasonix mcp install <name> is the single-server variant. That said, the fact that you couldn't find either is the real bug - the empty "no MCPs configured" state should point at both. I'll wire that hint in.

2. Marketplace titles / descriptions are English-only. Those strings come from the upstream MCP catalog (@modelcontextprotocol/servers index); we render them verbatim, we don't author them. A localized name/description overlay is doable but needs a community-maintained mapping table - it can't be auto-translated reliably for a marketplace. Happy to take a PR that introduces the overlay layer.

3. Localize slash commands themselves into Chinese. Going to push back on this one. /plan, /mcp, /resume are stable keys - translating the command names would split docs, screenshots, and muscle memory across locales for marginal gain. The descriptions you see next to each command already route through t() and render in Chinese under zh-CN. If specific descriptions still read awkwardly, point at them and they get fixed.

4 + 5. reasonix in folder B still uses folder A; only reasonix code <path> works. This one's a real defaults bug. Bare reasonix falls into chat mode, which doesn't root filesystem tools at the current working directory - reasonix code does, defaulting dir to process.cwd(). So "open terminal in B, type reasonix" gives you a chat that has no view of B at all, which is exactly the wrong surprise. The fix is either to make reasonix (no subcommand) default to code when the cwd looks like a project, or to print a one-line nudge when it doesn't. Filing this with a tracking issue and fixing in the next patch.

Thanks again - points 1 and 4 are both shipping fixes from this thread.

[huangsijun17]

能否嵌入Vscode、IDEA之类？

[tao996]

在 windows 11, powershell 7.6.1 下，按 ⇧↵ 无法换行，而是直接发送命令；
需要使用 \↵ 才能换行，但会吞掉两个字符

[cuetiger]

/help 的中文版本能否优化一下，跨行
没有翻译，

[kaerstphone]

会话发不出去，而且默认不能没有终端命令执行权限，重新安装了几次也没找到配置文件中关于系统终端执行权限的选项，上手难度提高了好多

[kaerstphone]

稍微滑动下鼠标，就这么多的无用符号，看着真难受

[wovw009]

桌面版直接聊天让它帮我装skills，但装了几次都没好，其他工具都是扫描一下就装好了，这一步也可以优化一下。另外，文件树目录看起来太乱了

[jaly05880002-cmyk]

桌面端右键左侧会话项会误触发 session_delete，导致本地会话文件被直接删除
问题描述
在 macOS 桌面版 Reasonix 中，左侧历史会话列表里的某条会话，正常应该支持右键打开上下文菜单；但实际行为是，右键该会话后，这条会话会立刻从左侧消失，并且对应的本地会话文件也被删除。
这不是单纯的 UI 刷新问题，而是真实的数据删除。
环境
系统：macOS
应用：Reasonix Desktop
复现日期：2026-05-15
我本地验证过的版本：0.42.0-3
0.43.0

两个版本都能复现。
复现步骤
启动 Reasonix 桌面应用。
新建一个会话，输入一条最简单的消息，例如 probe。
等左侧“近期”中出现该会话记录。
对左侧该会话项点击右键。
预期结果
打开会话项的上下文菜单，或者至少不做 destructive action。
本地会话文件应继续保留。
实际结果
左侧该会话立即消失。
应用没有弹出确认删除。
对应的本地会话文件会被直接删除。
重启应用后，该会话不会重新出现。
本地文件层证据
会话文件位于：
~/.reasonix/sessions/.jsonl
~/.reasonix/sessions/.meta.json
复现时我监控了 ~/.reasonix/sessions，观察到：
右键前，.jsonl 和 .meta.json 都存在
右键后，目录中的对应文件立即消失
例如一次复现中，会话名为：
desktop-202605151135-1
右键前存在：
desktop-202605151135-1.jsonl
desktop-202605151135-1.meta.json
右键后目录变为 total 0。
代码层定位
我在本地安装包中确认了删除链路：
桌面桥接层收到删除命令
文件：
desktop-JK3XH74F.js (line 878)
关键逻辑：
if (msg.cmd === "session_delete") {
deleteSession(msg.name);
实际文件删除逻辑
文件：
chunk-P2MH5BHY.js (line 200)
deleteSession(name) 会直接删除：
.jsonl
.meta.json
.pending.json
.plan.json
.events.jsonl
关键确认
我临时在本地桥接层加过调试日志，复现右键操作时，桥接层实际收到的是：
json

{"ts":"2026-05-15T11:36:12.946Z","tabId":"t1","cmd":"session_delete","name":"desktop-202605151135-1"}

这说明问题不是“右键后某个后台清理器误删了文件”，而是：
前端右键会话项
前端错误发出 session_delete
桥接层按正常删除路径执行
会话文件被真实删除
影响
用户只做右键操作，就可能永久丢失会话历史
没有确认框
数据破坏风险较高
推测根因
桌面前端对左侧会话项的右键事件处理有误，可能把“打开上下文菜单”错误映射成了“删除当前会话”。
建议修复方向
右键默认不应触发 session_delete
删除动作必须经过明确菜单项和二次确认
即使要支持右键菜单，也应先区分：contextmenu
左键选择
真正的删除点击

最低限度也应为 session_delete 增加确认保护

[jaly05880002-cmyk]

问题 2：状态栏会话统计无法恢复
现象
底部状态栏中的以下字段只在当前会话活跃运行后显示真实值：

cache
tokens
本次
但在以下场景会恢复成 0：

重启应用后重新打开会话
切到别的会话后再切回该会话
关键观察
运行中的新会话，底栏显示正常
已保存会话重新打开时，主消息能恢复，但状态栏统计不恢复
旧会话的 ~/.reasonix/sessions/*.meta.json 中只保存了 workspace 和 summary
缺少用于状态恢复的字段：
totalCostUsd
turnCount
cacheHitTokens
cacheMissTokens
lastPromptTokens
根因
桌面桥接层之前没有在每次 assistant_final 后把会话统计持久化到 .meta.json。

结果是：

当前进程内的 live turn 可以让底栏显示真实值
但一旦重启或重新加载会话，磁盘上没有足够统计数据可恢复，只能显示 0

[zmn28hgbn59kcmlpio8unfh7fdre523esd28q9a]

/slash commands

the only thing that i find inconvenient is having to launch web browser (/dashboard) to change reasoning effort per turn when needed; i mostly use high effort but for some problems max is better.

if possible to have /effort command back would mean a lot to me.

[wovw009]

这个图标可以加个链接，点击转到官网。

[wovw009]

qian's浅色模式下的代码块不明显

[wovw009]

按ESC后没有动画，建议加个动画反馈。

[wubo-ux]

每次打开窗口都要切换浏览器地址，感觉很不方便。还有网址的显示，一旦通过对话刷掉后就找不到了，能不能优化下，通过快捷键展示或者展示在固定的地方

[Shihengtao2324]

发送的内容直接溢出对话框