# v0.21.0 Release Notes

> v0.20.4 -> v0.21.0

## Summary

Splits the runtime into a TUI process and a long-lived daemon, with a new conversational interface that fork-execs the daemon on first launch. Adding or removing a model now reloads both sides through a config watcher, so the running daemon never needs a restart. The legacy tview interface is removed.

<details>
<summary>翻譯</summary>

重構 runtime 為 TUI 與長期運行 daemon 雙進程分離，新的對話式介面在首次啟動時 fork-exec daemon。新增或移除 model 透過 config 監看自動同步兩端 —— 運行中的 daemon 無需重啟。舊版 tview 介面已移除。

</details>

## ⚠️ Breaking Changes

### Legacy `tview` TUI removed

**Before:**
The interactive shell ran on `rivo/tview` with cell-based panes, command mode, and a separate dashboard.

**After:**
A bubbletea inline chat replaces the old surface. `agen` (no args) now boots the new TUI in-place; on first launch it fork-execs the daemon (HTTP, Discord, scheduler) and attaches via the runtime UID file. There is no fallback flag for the legacy view.

**Migration:**
End users only need `make build`. The CLI sub-commands (`agen cli`, `agen run`, `agen model`, `agen skill`, `agen mcp`, `agen session`, `agen stop`) keep their existing surface and behavior. Custom integrations referencing the archived TUI package must migrate to `internal/tui/` (bubbletea). The previous implementation is preserved at `internal/_tui_archived/` for reference and is excluded from build by the `_`-prefix convention.

<details>
<summary>翻譯</summary>

舊版 `tview` 介面已移除，改為 bubbletea inline chat。`agen`（無參數）直接啟動新 TUI；首次啟動會 fork-exec daemon 處理 HTTP／Discord／scheduler，並透過 runtime UID 檔對接。**無回退舊版的旗標**。一般使用者只需 `make build`；CLI 子指令（`agen cli`／`run`／`model`／`skill`／`mcp`／`session`／`stop`）行為不變。引用過舊 TUI package 的自訂整合請改用 `internal/tui/`，舊實作封存於 `internal/_tui_archived/`，靠 `_` 前綴慣例排除於 build。

</details>

## Changes

### FEAT
- Replace tview with a Claude Code–like bubbletea inline chat (@pardnchiu) [a1dbbb4]
- Add host hot reload and centralize runtime agent state (@pardnchiu) [ef078c6]
- Add TUI model management commands (@pardnchiu) [2973443]
- Add planner model and reasoning level selectors to TUI (@pardnchiu) [3b84fb2]
- Add initial model setup check before agent and TUI startup (@pardnchiu) [9420e71]
- Add workdir context and enrich session event logging (@pardnchiu) [c19b045]
- Add grouped CLI commands and interactive session pickers (@pardnchiu) [c4a4c02]
- Add secret prompt support and credential auto-heal flow (@pardnchiu) [5a4c1b9]

<details>
<summary>翻譯</summary>

- 以 Claude Code 風格的 bubbletea inline chat 取代 tview
- 加入 host 熱重載並集中 runtime agent 狀態
- 加入 TUI model 管理指令（list / add / remove）
- 加入 TUI planner / reasoning 選擇器
- 啟動 agent 與 TUI 前先檢查 model 設定
- 加入 workdir context 與更豐富的 session event log
- 加入分組 CLI 指令與互動式 session picker
- 加入 secret prompt 與憑證自動修復流程

</details>

### BREAKING
- Remove legacy tview TUI implementation (@pardnchiu) [e1e967a]

<details>
<summary>翻譯</summary>

- 移除舊版 tview TUI 實作

</details>

### UPDATE
- Refine skill scanner, external fetcher empties, and minor cleanup (@pardnchiu) [a51649f]
- Support cd in run_command and refresh tool description (@pardnchiu) [a6ddd46]

<details>
<summary>翻譯</summary>

- 精煉 skill scanner、external fetcher 空結果處理與小幅清理
- run_command 支援 cd，並更新 tool description

</details>

### DOC
- Document TUI single-package design rationale (@pardnchiu) [8e3a5fe]
- Add bilingual wiki and refresh README for platform docs (@pardnchiu) [ea5d570]
- Refresh README positioning for parallel multi-agent runtime (@pardnchiu) [61c7d2f]

<details>
<summary>翻譯</summary>

- 補上 TUI 單一 package 設計理由文件
- 加入雙語 wiki，README 更新平台說明
- README 定位調整為「並行多 agent runtime」

</details>

***

Generated by [SKILL](https://github.com/pardnchiu/skill-version-generate)