WispTerm v1.33.0
This release adds ACP external agent sessions (connect agents like codex-acp
with messages, tool cards, permissions, and cancel), Windows native shell
integration, the AI memory digest center, and a refreshed command palette with
fade transitions and a scrollable result list.
Added
- ACP external agent sessions (#546, #549–#554). External agents that speak
the Agent Client Protocol (e.g.codex-acp) can now run as a WispTerm session
mode with streamed messages, tool cards, permission prompts, and cancel. ACP
profiles add a command field and are exempt from thebase_url/model
requirement. - ACP terminal capability backed by real panes. Agents can drive real
WispTerm terminal panes, with exit-status and kill-child primitives exposed to
the host. - Windows native shell integration (#555). The native portable Windows build
now ships shell integration. - AI memory digest center (#543). A memory center surfaces AI memory digests.
- Date-aware memory search (#540). Memory search now understands dates.
- Agent terminal leases (#544). Agent terminals are managed through leases.
- Command palette "Star Me" (#561). A new command opens the GitHub repo.
- Scrollable command palette results (#560). The full result list now
scrolls past the 14-row window. - Overlay fade transitions (#559). All floating overlays fade in and out.
Changed
- Command center aligned with Ghostty (#558). Command center visuals now
match Ghostty and include animations. cli_agenttool removed. Thecli_agenttool is superseded by ACP
external agent sessions.
Fixed
- Skill center scroll follows selection (#556). The library list now scrolls
to keep the selected item visible. - Side copilot stays bound to restored terminals (#545). Restored terminals
keep their side copilot binding. - WebView2 loader path overflow (#538). Fixed a stack buffer overflow when
building the WebView2 loader path on Windows. - ACP hardening. codex-acp
rawOutput.stdoutfallback, verbatim string
request ids, restored-session command persistence, Windows terminal-capability
gating, and permission-path race hardening.
Known limitations
- Windows native D3D11 is feedback-only. Use the default OpenGL package if
the native package shows a black window, crash, missing UI, resize failure,
RDP issue, or multi-monitor/DPI issue. Please include diagnostics, GPU/driver,
Windows version, and display/session topology when reporting native-renderer
issues. - Linux is experimental. The Linux AppImage is published for community
testing and is not yet considered stable. - macOS remote access remains early. The macOS relay transport is available
but still needs more end-to-end field testing.
WispTerm v1.33.0(中文)
本版本新增 ACP 外部 agent 会话(可接入 codex-acp 等 agent,支持消息流、工具卡片、
权限确认和取消),Windows native shell 集成,AI 记忆摘要中心,以及带淡入淡出过渡
和可滚动结果列表的全新命令面板。
新增
- ACP 外部 agent 会话(#546、#549–#554)。 支持 Agent Client Protocol 的外部
agent(如codex-acp)现在可以作为 WispTerm 会话模式运行,支持消息流、工具卡片、
权限提示和取消。ACP profile 新增 command 字段,且不受base_url/model必填约束。 - ACP terminal 能力由真实 pane 支撑。 Agent 可以驱动真实的 WispTerm 终端 pane,
host 侧暴露 exit-status 和 kill-child 原语。 - Windows native shell 集成(#555)。 native 便携版 Windows 构建现在附带 shell 集成。
- AI 记忆摘要中心(#543)。 记忆中心现在会呈现 AI 记忆摘要。
- 日期感知的记忆搜索(#540)。 记忆搜索现在能理解日期。
- Agent terminal leases(#544)。 Agent 终端现在通过 lease 管理。
- 命令面板 "Star Me"(#561)。 新增命令,可打开 GitHub 仓库。
- 命令面板结果可滚动(#560)。 完整结果列表现在可以滚动超过 14 行窗口。
- Overlay 淡入淡出过渡(#559)。 所有浮层现在都有淡入淡出效果。
调整
- 命令中心对齐 Ghostty(#558)。 命令中心视觉现在与 Ghostty 一致,并加入动画。
- 移除
cli_agent工具。cli_agent工具已被 ACP 外部 agent 会话取代。
修复
- 技能中心滚动跟随选中项(#556)。 库列表现在会滚动以保持选中项可见。
- 侧边 copilot 保持绑定到恢复的终端(#545)。 恢复的终端会保留其侧边 copilot 绑定。
- WebView2 loader 路径溢出(#538)。 修复 Windows 上构建 WebView2 loader 路径时的
栈缓冲区溢出。 - ACP 加固。 codex-acp
rawOutput.stdout回退、原样回显字符串请求 id、恢复会话的
command 持久化、Windows terminal 能力门禁,以及 permission path 竞态加固。
已知限制
- Windows native D3D11 仅作为反馈包。 如果 native 包出现黑屏、崩溃、UI 缺失、
resize 失败、RDP 问题或多屏/DPI 问题,请切回默认 OpenGL 包。反馈 native renderer
问题时,请附上诊断、GPU/驱动、Windows 版本和显示器/会话拓扑。 - Linux 仍为实验性质。 Linux AppImage 用于社区测试,尚不视为稳定版本。
- macOS 远程访问仍为早期功能。 macOS 中继传输已经可用,但仍需要更多端到端实际验证。
wisptermctl (agent terminal control CLI) included in this release:
wisptermctl-<version>.zip: all desktop builds in one archive (Linux x86_64/aarch64, macOS Intel/Apple Silicon, Windows x86_64). Extract it and pick the binary for your platform — see the bundledREADME.txt.- Enable the API in WispTerm with
agent-control-enabled = true, restart, then runwisptermctl panes.
wisptermctl 是 WispTerm 智能体终端控制 API 的独立命令行客户端。该压缩包内含所有桌面平台的构建,解压后按需选择对应平台的可执行文件即可(详见包内
README.txt)。
What's Changed
- fix(win32): skip WGL context creation in the native d3d11 build by @xuzhougeng in #509
- fix(d3d11): cut per-thread TLS cost, cache shader compiler, drop GL leftovers by @xuzhougeng in #510
- fix: move the big shared threadlocal state out of the TLS template by @xuzhougeng in #511
- fix(memory): validate memory names and add substring fallback to recall by @xuzhougeng in #512
- fix(remote): 远程 Web 控制台快照下发 VT 模式状态,修复全屏 TUI 无法回看历史 by @xuzhougeng in #513
- feat(assistant): collapse tool-call runs into one activity row; add /copy by @xuzhougeng in #514
- [codex] fix win32 ime punctuation handling by @xuzhougeng in #517
- perf(windows): shrink per-surface IO thread stack commit; honest page-pool accounting by @xuzhougeng in #515
- feat: memory digest M1 — local AI chat log collector and daily JSON artifacts by @xuzhougeng in #518
- [codex] Optimize stream buffer growth by @xuzhougeng in #519
- [codex] Add AI History selected actions by @xuzhougeng in #520
- feat: memory digest M2a-M4 — llm digestion, scheduler, remote sources, manual trigger by @xuzhougeng in #521
- feat: memory digest M5 — llm timeouts, token usage, session ref fidelity by @xuzhougeng in #523
- [codex] Fix AI history oversized session scan by @xuzhougeng in #524
- [codex] Fix AI History action button labels by @xuzhougeng in #522
- [codex] fix ai history large transcript actions by @xuzhougeng in #525
- Add progress toast for manual memory digest runs by @xuzhougeng in #526
- Add memory center viewer by @xuzhougeng in #527
- Fix memory digest local root resolution by @xuzhougeng in #528
- Fix MCP cache cleanup and move Memory Center to tab by @xuzhougeng in #529
- Move Memory Center to dedicated tab by @xuzhougeng in #530
- Fix Memory Center source label overlap by @xuzhougeng in #531
- Add guarded WispTerm config tool and remote digest coverage by @xuzhougeng in #532
- Add memory_search copilot tool by @xuzhougeng in #534
- [codex] fix WebView2 reload vtable layout by @xuzhougeng in #535
- Backfill digest summaries and surface per-source diagnostics by @xuzhougeng in #536
- Backfill quota counts only LLM attempts; capture remote find failure by @xuzhougeng in #537
- Fix stack buffer overflow in WebView2 loader path building by @xuzhougeng in #538
- feat(tools): cli_agent — delegate self-contained tasks to external CLI agents (codex) by @xuzhougeng in #541
- feat(agent): add date-aware memory search by @xuzhougeng in #540
- Scope memory digest status to Memory Center by @xuzhougeng in #543
- Isolate Agent terminal ownership by @xuzhougeng in #544
- fix: keep Side Copilot bound to its terminal tab by @xuzhougeng in #545
- feat: ACP protocol core (schema + stdio client) by @xuzhougeng in #546
- feat: ACP external agent session mode by @xuzhougeng in #554
- feat: ACP terminal capability + remove cli_agent by @xuzhougeng in #549
- fix(acp): fall back to codex-acp rawOutput.stdout when tool content is empty by @xuzhougeng in #550
- fix(acp): persist acp_command so restored sessions work without re-picking profile by @xuzhougeng in #551
- feat(acp): let ACP profiles be command-only (no base_url/model) by @xuzhougeng in #552
- fix(acp): three final-review hardening follow-ups by @xuzhougeng in #553
- feat(windows): add native portable shell integration by @xuzhougeng in #555
- fix(skill-center): 列表溢出时可滚动/翻页 (#556) by @xuzhougeng in #557
- feat(palette): align command center visuals with Ghostty and add animations by @xuzhougeng in #558
- feat(overlays): fade in/out transitions for all floating overlays by @xuzhougeng in #559
- feat(palette): make the full result list scrollable past the 14-row window by @xuzhougeng in #560
- feat(palette): add "Star Me" command that opens the GitHub repo by @xuzhougeng in #561
Full Changelog: v1.32.0...v1.33.0
Linux asset included in this release:
- AppImage: portable, self-contained x86_64 build (bundles SDL3). Run
chmod +x WispTerm-*-x86_64.AppImage && ./WispTerm-*-x86_64.AppImage; on hosts without FUSE add--appimage-extract-and-run.
⚠️ The Linux build is experimental and not yet stable. The maintainer has no Linux desktop environment to test it on, so community testing is very welcome. If you hit a problem, please ask an AI assistant to help analyze it first, then open an issue with the details: https://github.com/xuzhougeng/wispterm/issues/new
⚠️ Linux 版本目前为实验性质,尚不稳定,且作者没有 Linux 桌面环境进行测试,欢迎社区参与测试。如遇到问题,请先用 AI 协助分析,然后到这里提交 issue:https://github.com/xuzhougeng/wispterm/issues/new