openclacky 1.3.2 → 1.3.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ed703cddac3ffa9887b5c500c5dfbe57c895eb5aab0e9dc3338592c9317555ec
-  data.tar.gz: 67d21c3c857e72bb729cfcecbdb3749eaaac1c76b21e1d0600081d1e4d79e880
+  metadata.gz: 8d5879a7f2c6eb0a1846dd3049fa79abd3ca53119750bd0a43b337339f146dad
+  data.tar.gz: 12a39e3d860e9e9e691424289543b73813bcb4652e11fe0719e72aa9e6c72760
 SHA512:
-  metadata.gz: 4fe46c92c67e5937bf24e325be47046a9ebf555afb722aaaaf108a17b2c13403c7e42c08d4b1a7abafad5c5ffb5d79d2749264c051572d157d0094dcb067ac78
-  data.tar.gz: 5fa8e909159560aa13944c0435716e7a98265504c6f61e8cfc298bc09553aa218ac404423d4e9b45f5a8d17563f0ae8a7a50547460fb497e06a98bc46b55aa53
+  metadata.gz: cdb47cb9da7cccae4329aa0d4b98f03d9e5cadf763c12b9cd255060e2f230154eed3e7404e494f9a0b7e7b54cdb569f2dc25a1ea69c0b8af386a4a1122942d65
+  data.tar.gz: 196c48e418e2119201664b920871aa489ff3531128a8aa8b981f73d6ddc95a7d3ef23ecb79da0611810b8af02735f83340ce0712ddb18ad30de0f94421dbd0a4

data/CHANGELOG.md

@@ -5,6 +5,60 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.3.4] - 2026-06-25
+
+### Added
+- Skill edit UI with brand skill theme colors
+- WebUI language preference propagated to backend for localized error messages
+- Edit message resend with confirmation modal and localStorage key normalization
+- Duplicate model card action
+- i18n support for aside tab labels (files/git/time-machine)
+- File picker defaults to workspace with mkdir/rename support and hardened validation
+- API extensions and EPIPE rebuild client handling
+- Ruby Rich enhancement and refactoring (runtime dependency added)
+
+### Improved
+- Default aside panel to collapsed; sidebar widths aligned to 16rem
+- Onboarding manual config UX and spacing improvements
+- Fixed positioning for modal model/baseurl dropdowns to avoid overflow clipping
+- Disable transition during aside resize drag
+- Rename resetAfterUnbind to resetBrandState to avoid view/store collision
+
+### Fixed
+- Edit tool performs literal replacement (C-5682)
+- Shield code spans before math extraction to prevent LaTeX rendering (C-5635)
+- Preserve updated_at on idle compression and session eviction; fix Today/Yesterday display bug
+- Remove media output dir UI setting — always use session workspace
+- Test: stub req.path and req.request_method in check_access_key loopback bypass spec
+
+## [1.3.3] - 2026-06-23
+
+### Added
+- Profile editor with CodeMirror for editing agent SOUL/USER files
+- Inline editing for memory cards
+- Workspace file preview, plus "copy path" in the context menu and a close button in the code editor
+- Time Machine: browse and restore previous workspace states via git
+- Image editing support in media generation
+- Copy and edit actions on user/assistant message bubbles
+- Media output directory configuration in settings
+- Web UI extension support
+- Health check endpoint and signal logging
+
+### Improved
+- Differentiated icons and reordered buttons in the context menu and memory card
+- Removed the standalone preview panel for a cleaner workspace layout
+- Throttle duplicate inbound channel messages
+- Session bar labels no longer wrap
+- Added Japanese README (README_JA.md)
+
+### Fixed
+- Lock the default-model checkbox when only one model exists (C-5677)
+- Jump to a session that is not yet loaded in the sidebar (C-5679)
+- Workspace panel now uses overlay mode on mobile
+- Clarified that `include_sessions` applies to auto-backup only (UI)
+- Removed extra padding from model cards in the grid
+- Moved profile fetch into the store and fixed the architecture spec
+
 ## [1.3.2] - 2026-06-18
 
 ### Added

data/Dockerfile

@@ -24,5 +24,8 @@ VOLUME ["/root/.clacky"]
 
 EXPOSE 7070
 
+HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
+  CMD curl -f http://localhost:7070/health || exit 1
+
 ENTRYPOINT ["openclacky"]
 CMD ["server", "--host", "0.0.0.0"]

data/README.md

@@ -7,7 +7,7 @@
 [![License](https://img.shields.io/badge/license-MIT-lightgrey?style=flat-square)](LICENSE.txt)
 
 <p align="center">
-  <a href="README.md">English</a> · <a href="README_CN.md">简体中文</a>
+  <a href="README.md">English</a> · <a href="README_CN.md">简体中文</a> · <a href="README_JA.md">日本語</a>
 </p>
 
 > Contributing? Read **[CONTRIBUTING.md](./CONTRIBUTING.md)** before opening a PR.

data/README_JA.md

@@ -0,0 +1,237 @@
+# OpenClacky
+
+[![Build](https://img.shields.io/github/actions/workflow/status/clacky-ai/openclacky/main.yml?label=build&style=flat-square)](https://github.com/clacky-ai/openclacky/actions)
+[![Release](https://img.shields.io/gem/v/openclacky?label=release&style=flat-square&color=blue)](https://rubygems.org/gems/openclacky)
+[![Ruby](https://img.shields.io/badge/ruby-%3E%3D%203.1.0-red?style=flat-square)](https://www.ruby-lang.org)
+[![Downloads](https://img.shields.io/gem/dt/openclacky?label=downloads&style=flat-square&color=brightgreen)](https://rubygems.org/gems/openclacky)
+[![License](https://img.shields.io/badge/license-MIT-lightgrey?style=flat-square)](LICENSE.txt)
+
+<p align="center">
+  <a href="README.md">English</a> · <a href="README_CN.md">简体中文</a> · <a href="README_JA.md">日本語</a>
+</p>
+
+> コントリビュートする場合は、PR を作成する前に **[CONTRIBUTING.md](./CONTRIBUTING.md)** をお読みください。
+
+**最もトークン効率の高いオープンソース AI エージェント。**
+
+OpenClacky は Claude Code と同等の性能を同等のコストで実現しつつ、他のオープンソースエージェントと比べて大幅にコストを削減します（OpenClaw 比で約 50%、Hermes 比で約 3 倍安価）。100% オープンソース（MIT）、任意の OpenAI 互換モデルで BYOK が可能で、2 年にわたるエージェント開発（Agentic R&D）とハーネスエンジニアリングの上に構築されています。
+
+> Web サイト: https://www.openclacky.com/ · 出資元 **MiraclePlus · ZhenFund · Sequoia China · Hillhouse Capital**
+
+## なぜ OpenClacky なのか？
+
+同じタスクで、どれだけ支払いますか？ 同等のエージェントワークロードにおいて、OpenClacky は主流の代替手段と比べて大量のトークン消費を節約します。
+
+| エージェント | 相対コスト | 備考 |
+|---|---|---|
+| **OpenClacky** | **約 0.8** | 16 ツール · キャッシュヒット率約 100% · サブエージェントルーティング |
+| Claude Code | 1.0×（基準） | 世界クラスのハーネス、クローズドソースのサブスクリプション |
+| OpenClaw | 約 1.5× | 同等のハーネスエージェント |
+| Hermes | 約 3× | 52 個の組み込みツール — スキーマの肥大化が約 3〜4 倍 |
+
+*数値は社内の一般的なエージェントタスクで計測した平均値であり、Claude Code を基準としています。詳細なベンチマークレポートは GitHub で公開予定です。*
+
+## 機能比較
+
+エージェントのコア性能はこの分野でおおむね横並びであり、本当の差別化要因は **コスト、オープン性、Skill の進化、そして統合機能** です。
+
+| 機能 | Claude Code | OpenClaw | Hermes | **OpenClacky** |
+|---|:---:|:---:|:---:|:---:|
+| トークンコスト | 1.0× | 約 1.5× | 約 3× | **約 0.8** |
+| オープンソース | ❌ クローズド | ✅ オープン | ✅ オープン | ✅ MIT |
+| BYOK / モデルの自由度 | ❌ Anthropic のみ | ✅ | ✅ | ✅ |
+| Skill の自己進化 | ❌ | ❌ | ✅ | ✅ |
+| IM 統合（Feishu/WeCom/WeChat/Discord/Telegram） | ❌ | ✅ | ✅ | ✅ |
+
+## どうやってコストを下げているのか
+
+機能を削るのではなく、すべてのレイヤーで正しい選択を積み重ねることで実現しています。
+
+### 1. 超高水準のキャッシュヒット率
+セッションを再起動しない、ダブルキャッシュマーカー、**Insert-then-Compress（挿入してから圧縮）** — システムプロンプトは決して書き換えられないため、圧縮後もキャッシュを再利用できます。**計測されたキャッシュヒット率: ほぼ 100%。**
+
+### 2. 最小限のツールセット
+**コアツールはわずか 16 個** です。機能は単一の `invoke_skill` メタツールを介して Skill エコシステムにオフロードされます。指標はツールの数ではなく、タスクの完了率です。
+
+| OpenClacky | Claude Code | OpenClaw | Hermes |
+|:--:|:--:|:--:|:--:|
+| **16** | 40+ | 23 | 52 |
+
+### 3. アイドル時の自動圧縮
+会議に行く、コーヒーを淹れる — その間にエージェントは長いコンテキストをバックグラウンドで圧縮し、キャッシュを事前にウォームアップします。戻ってきて最初に送るメッセージは直接キャッシュにヒットします。**コールドスタート時の初回トークンコストを 50% 以上削減。**
+
+### 4. BYOK — モデルを自分で選び、コストを自分で決める
+任意の OpenAI 互換 API をプラグアンドプレイで利用できます。公式の直接接続、集約ルーティング、互換リレー — 選択は 100% あなた次第です。コードには Claude を使い、サブタスクは自動的に DeepSeek にルーティングして、さらにトークンを節約しましょう。
+
+**2 年 · 3 世代のエージェントアーキテクチャ · 6 つのコアハーネスエンジニアリングの意思決定** の上に構築されています。
+
+## Skill — エージェントの魂
+
+- **`/` で呼び出す** — 瞬時の閲覧、あいまい検索、ダイレクトコール。何百もの Skill を指先で操作できます。
+- **自然言語で Skill を作成** — やりたいことを説明するだけで、エージェントが `SKILL.md` を起草し、手順を分解し、検証を実行します。コードは不要です。
+- **自己進化** — 各実行のあと、エージェントは実行コンテキストと結果に基づいて Skill を更新します。次回の呼び出しはより安定し、より正確になります。
+- **オープンで互換性が高い** — Claude Skills / Markdown Pack / カスタム形式をサポートします。
+- **収益化が可能** — 洗練された Skill はパッケージ化して販売でき、暗号化配布、License 管理、作者が設定する価格設定に対応します。
+
+## インストール
+
+### デスクトップインストーラー（推奨）
+
+ダブルクリックでインストール — 環境、依存関係、Skill のすべてが自動的にセットアップされます。
+
+- **macOS** — [`.dmg` をダウンロード](https://oss.1024code.com/openclacky-installer/official/openclacky-installer.dmg)（Apple Silicon / Intel）
+- **Windows** — [`.exe` をダウンロード](https://oss.1024code.com/openclacky-installer/official/openclacky-installer.exe)（Windows 10 2004+ / Windows 11）
+
+その他のオプション: https://www.openclacky.com/
+
+### コマンドライン
+
+ワンラインインストール（Mac/Ubuntu）:
+
+```bash
+/bin/bash -c "$(curl -sSL https://raw.githubusercontent.com/clacky-ai/openclacky/main/scripts/install.sh)"
+```
+
+Windows:
+
+```bash
+powershell -c "& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/clacky-ai/openclacky/main/scripts/install.ps1')))"
+```
+
+または Ruby（3.x/4.x）を使う場合:
+
+**要件:** Ruby >= 3.1.0
+
+```bash
+gem install openclacky
+```
+
+詳細はこちら: https://www.openclacky.com/docs/installation
+
+### Docker
+
+ビルド:
+
+```bash
+git clone https://github.com/clacky-ai/openclacky.git
+cd openclacky
+docker build -t openclacky .
+```
+
+**Linux:**
+
+```bash
+docker run -d --network=host -e CLACKY_ACCESS_KEY="" openclacky
+```
+
+`--network=host` は、コンテナ内のエージェントがホスト上で動作する Chrome のリモートデバッグポートに到達するために必要です。
+
+**macOS / Windows:**
+
+```bash
+docker run -d -p 7070:7070 -e CLACKY_ACCESS_KEY="" openclacky
+```
+
+> **注意:** macOS/Windows では `--network=host` がサポートされていないため、ブラウザの自動化が制限される場合があります。
+
+起動後、**http://localhost:7070** を開いてください。
+
+環境変数:
+
+| 変数 | 説明 |
+|---|---|
+| `CLACKY_ACCESS_KEY` | アクセスキーで Web UI を保護します（空の場合はパブリックモード） |
+
+
+## クイックスタート
+
+### ターミナル（CLI）
+
+```bash
+openclacky            # カレントディレクトリで対話型エージェントを起動
+```
+
+### Web UI
+
+```bash
+openclacky server     # デフォルト: http://localhost:7070
+```
+
+**http://localhost:7070** を開くと、マルチセッション対応の本格的なチャットインターフェースが利用できます — コーディング、コピーライティング、リサーチのセッションを並行して実行できます。
+
+オプション:
+
+```bash
+openclacky server --port 8080        # カスタムポート
+openclacky server --host 0.0.0.0     # すべてのインターフェースでリッスン（リモートアクセス）
+```
+
+## 設定
+
+```bash
+$ openclacky
+> /config
+```
+
+**API Key**、**Model**、**Base URL**（任意の OpenAI 互換プロバイダー）を設定します。
+
+標準でサポート: **Claude (Anthropic) · GPT (OpenAI) · DeepSeek · Kimi (Moonshot) · MiniMax · OpenRouter** — または任意のカスタムエンドポイント。
+
+## コーディングのユースケース
+
+OpenClacky は汎用 AI コーディングアシスタントとして機能します — フルスタックアプリの雛形作成、機能追加、あるいは未知のコードベースの探索が可能です:
+
+```bash
+$ openclacky
+> /new my-app        # 新しいプロジェクトの雛形を作成
+> メールとパスワードによるユーザー認証を追加して
+> 決済モジュールはどのように動作しますか？
+```
+
+## Star History
+
+<a href="https://www.star-history.com/?repos=clacky-ai%2Fopenclacky&type=date&legend=top-left">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=clacky-ai/openclacky&type=date&theme=dark&legend=top-left" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=clacky-ai/openclacky&type=date&legend=top-left" />
+   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=clacky-ai/openclacky&type=date&legend=top-left" />
+ </picture>
+</a>
+
+## 上級者向け — クリエイタープログラム
+
+すでにパワーユーザーたちは、自身のワークフローを OpenClacky 上の垂直特化型 AI エキスパートへと変えています — 暗号化配布、License 管理、自分で設定する価格。法務、医療、ファイナンシャルプランニングなど、さまざまな分野で展開されています。
+
+詳細はこちら: https://www.openclacky.com/ → Creators
+
+## ソースからのインストール
+
+```bash
+git clone https://github.com/clacky-ai/openclacky.git
+cd openclacky
+bundle install
+bin/clacky
+```
+
+## 信頼性と信用
+
+- **100% オープンソース** — MIT ライセンス、すべてのコードが公開され、すべての意思決定が追跡可能
+- **2 年にわたるエージェント開発（Agentic R&D）** — 3 世代のアーキテクチャ
+- **16 個のコアツール** — 設計思想としての最小主義
+- **出資元** MiraclePlus · ZhenFund · Sequoia China · Hillhouse Capital
+
+## コントリビューター
+
+すべてのコード、バグ報告、そして丁寧なレビューが大切です。OpenClacky をより良くしてくださり、ありがとうございます。
+
+<a href="https://github.com/clacky-ai/openclacky/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=clacky-ai/openclacky" />
+</a>
+
+## コントリビュート
+
+バグ報告とプルリクエストは GitHub（ https://github.com/clacky-ai/openclacky ）で歓迎しています。コントリビューターは[行動規範](https://github.com/clacky-ai/openclacky/blob/main/CODE_OF_CONDUCT.md)を遵守することが求められます。
+
+## ライセンス
+
+[MIT ライセンス](https://opensource.org/licenses/MIT)のもとでオープンソースとして利用可能です。

data/docs/rich_ui_guide.md

@@ -0,0 +1,277 @@
+# OpenClacky Rich UI Mode — Operations and Interface Display
+
+> Source directory: `lib/clacky/rich_ui/`
+> Terminal TUI interface built on the RubyRich library
+
+---
+
+## I. Overall Architecture
+
+`lib/clacky/rich_ui` is OpenClacky's terminal TUI interface module, built on the `RubyRich` library, implementing a complete terminal user interaction interface. The core entry point is `RichUIController` (`rich_ui_controller.rb`), which manages layout, components, events, and lifecycle through `RichAgentShell`.
+
+---
+
+## II. Interface Layout (7-layer Zoning)
+
+The interface is defined by the zoning layout in `RichAgentShell#build_layout`:
+
+| Zone | Name | Description |
+|------|------|-------------|
+| Row 1 | **Header** | Top title bar, displays `OpenClacky` title/subtitle |
+| Main body left | **Transcript** | Conversation viewport, displays user messages, assistant replies, tool calls, etc. |
+| Main body right | **Sidebar** | Sidebar (36 columns wide), contains Work / Tasks / Context three panels |
+| Main body bottom | **ThinkingLive** | Real-time thinking display area (dynamically appears/disappears, height 0 or 6 rows) |
+| From row 6 | **Composer** | Input editor, with Framed border titled "Composer" |
+| Last row | **Status** | Bottom status bar, displays current mode, model, task count, cost, etc. |
+
+---
+
+## III. Sidebar — Three Information Panels
+
+The sidebar (`RichSidebar`, `components/sidebar.rb`) supports multiple display modes, switched via F1-F4 shortcuts:
+
+- **F1 → Work panel**: Displays plan description, up to 8 recent tool activities (with status markers), task count and cost statistics
+- **F2 → Tasks panel**: Displays the current task list (from `update_todos`), with completion progress (e.g. `3/5 done`), status markers:
+  - `✓` (green) = Completed
+  - `●` (blue) = In progress
+  - `!` (red) = Failed
+  - `○` (gray) = Pending
+- **F3 → Auto mode**: Automatically displays all panels that have content
+- **F4 → Context panel**: Displays Token usage details (prompt / output / total / cost)
+
+Sidebar panels are implemented by `components/sidebar_panels.rb`:
+- `RichWorkPanel`: Work progress panel
+- `RichTasksPanel`: Task list panel
+- `RichContextPanel`: Context / Token info panel
+
+---
+
+## IV. Bottom Status Bar
+
+`RichStatusView` (`components/status_view.rb`) renders a single row of status information at the very bottom of the terminal:
+
+- **Idle state**: Shows mode name + "idle" + model name + task count + cost + "Ctrl+C quit"
+- **Working**: Shows rotating spinner animation + current tool name (e.g. "web_search…") + model/latency + task count + cost
+- **Ctrl+C warning**: Red prompt "Press Ctrl+C again to exit"
+- Latency info is appended after the model name (format: `model_name (1.2s)`)
+
+---
+
+## V. Transcript — Operations and Display
+
+### 5.1 Message Display
+
+- **User messages**: Displayed directly in the conversation area
+- **Assistant replies**: Rendered in Markdown format (supports code blocks, tables, lists, etc.)
+  - Long text (≥240 characters) triggers **streaming rendering**: 6 characters per chunk, 0.03s interval, appearing progressively
+  - File summaries are automatically appended at the end of replies (e.g. `Files - path/to/file.rb`)
+- **System messages**: Regular info / warning / error displayed in different colors
+- **Welcome banner**: On first launch, displays `WelcomeBanner` containing working directory, mode, etc.; if there is session history, shows a "recent session" separator and the last user message
+
+### 5.2 Thinking Process Display (Two Phases)
+
+1. **Live phase**: `ThinkingLiveView` (`components/thinking_live_view.rb`) dynamically appears (occupying 6 rows), renders thinking content character by character in real time, with a rotating spinner and elapsed time counter, stays for about 0.6s after completion
+2. **Collapsed phase**: Thinking content is retained in the conversation area as a collapsed block (marked "Xs"), press Ctrl+O to expand and view
+
+### 5.3 Tool Call Display
+
+Each tool call process is visualized in three steps:
+
+- **Start**: Insert a `running` status entry in the conversation area, displaying tool name and parameters (truncated as needed, e.g. `web_search("query...")`, `web_fetch(hostname)`)
+- **Complete**: Update entry status to `done` (green `[OK]`), with output content appended
+- **Error**: Update entry status to `error` (red `[Error]`), with error message appended
+
+Tool activities are simultaneously synced to the sidebar Work panel (up to 12 entries recorded).
+
+### 5.4 Diff Display
+
+Through the `show_diff` method, using the `Diffy` library to generate unified format diffs, truncated to 50 visible lines (excess lines indicate hidden count), with stats appended (e.g. `+5, -3, 2 hunks`).
+
+### 5.5 Token Usage Display
+
+`show_token_usage` displays prompt/output/total token counts and cost estimates in the conversation area, while syncing to the sidebar Context panel.
+
+### 5.6 Text Selection and Copy
+
+`ViewportSelection` (`extensions/viewport_selection.rb`) extends `RubyRich::Viewport`, supporting:
+
+- **Mouse selection**: Left-click drag to select text, highlighted with reverse color
+- **Right-click copy**: Copy selected text to system clipboard
+- **Multi-platform clipboard support**: Linux (wl-copy / xclip / xsel), macOS (pbcopy), Windows, with OSC 52 terminal protocol fallback
+
+### 5.7 Table Rendering Optimization
+
+`MarkdownTableAdapter` (`extensions/markdown_table_adapter.rb`) extends RubyRich's Markdown converter, enabling tables to adapt to terminal width: calculating natural column widths, proportionally compressing columns when exceeding terminal width, and auto-wrapping long text.
+
+---
+
+## VI. Composer (Input Area) — Operations
+
+### 6.1 Basic Operations
+
+- **Text input**: Single-line editor, `Shift+Enter` for newline
+- **History navigation**: Up/down arrows to browse message history
+- **Vim scrolling**: Type `/vim` to toggle, enabling `j`/`k` to scroll the conversation area in single-line mode
+- **Clear**: `Ctrl+C` first press interrupts current task, second press exits; `Esc` multi-layer cancel (see below)
+
+### 6.2 Slash Commands
+
+Built-in commands trigger a dropdown menu via `/`:
+
+| Command | Description |
+|---------|-------------|
+| `/clear` | Clear output and restart session |
+| `/config` | Open model configuration dialog |
+| `/undo` | Restore previous task state |
+| `/help` | Show help information |
+| `/exit` | Exit application |
+| `/model` | Switch LLM model |
+
+Skill slash commands are also dynamically registered in the Composer menu, with descriptions truncated to 50 characters.
+
+### 6.3 Esc Multi-Layer Cancel Stack
+
+Pressing `Esc` processes in priority order:
+
+1. Close any open dialog (if present)
+2. Close slash menu (if open)
+3. Interrupt running task
+4. Clear input field text (Composer native behavior)
+
+---
+
+## VII. Dialog System
+
+RichUI provides three dialog types, all running in blocking mode (calling `show_blocking_dialog`):
+
+### 7.1 Approval Dialog (ApprovalDialog)
+
+File: `components/dialogs/approval_dialog.rb`
+
+Security confirmation before tool execution, displaying:
+- **Tool name** + category badge (File/Shell/Network/Paid, different colors)
+- **Risk level**: Low (green), Medium (yellow), High (yellow), Critical (red), with `●○○○` style progress bar
+- **Tool info** and parameter details
+- Three action buttons: `Approve`, `Deny`, `Always allow` (fingerprint whitelist)
+
+Navigation: `←`/`→` or `h`/`l` to switch options, `Enter` to confirm, `Esc` to deny.
+
+### 7.2 Configuration Menu Dialog (ConfigMenuDialog)
+
+File: `components/dialogs/config_menu_dialog.rb`
+
+Opened by `/config` command, for model management:
+- Lists all configured models (showing API Key mask, type labels)
+- Actions: Switch model / Add new model / Edit current model / Delete model / Close
+- When adding a model, first select Provider (pre-configured vs custom), then fill in API Key, Model name, Base URL form
+- Connection test verification available after adding/editing
+
+Navigation: `↑`/`↓` or `j`/`k` to move, `Enter` to select, `q`/`Esc` to cancel.
+
+### 7.3 Form Dialog (FormDialog)
+
+File: `components/dialogs/form_dialog.rb`
+
+General-purpose form input, used for model editing and similar scenarios:
+- Supports multiple fields (with labels, default values, placeholders, password masking)
+- Focused field shows `➜` marker
+- Navigation: `↑`/`↓`/`Tab`/`Shift+Tab` to switch fields, `Enter` to submit, `Esc` to cancel
+
+### 7.4 Model Switch Dialog
+
+Triggered by `/model` command, two-step operation:
+1. Select target model from the available model list
+2. Choose scope: current session only / save permanently
+
+---
+
+## VIII. Keyboard Shortcut Overview
+
+| Shortcut | Scope | Function |
+|----------|-------|----------|
+| `Ctrl+C` | Global (within 1s) | Interrupt current task |
+| `Ctrl+C` | Global (after 1s) | Exit program |
+| `Ctrl+M` | Global (within 2s) | Toggle permission mode (confirm_safes ↔ confirm_all) |
+| `Tab` | Global | Toggle permission mode + refocus Composer |
+| `F1` | Global | Sidebar → Work panel |
+| `F2` | Global | Sidebar → Tasks panel |
+| `F3` | Global | Sidebar → Auto mode |
+| `F4` | Global | Sidebar → Context panel |
+| `Esc` | Global | Multi-layer cancel (dialog→menu→interrupt→clear input) |
+| `Shift+Enter` | Composer | Newline |
+| `↑`/`↓` | Composer | History message navigation |
+| `j`/`k` | Composer (single-line mode) | Scroll conversation area |
+| `Ctrl+O` | Transcript | Expand/collapse thinking block |
+| Left-click drag | Transcript | Select text |
+| Right-click | Transcript | Copy selected text |
+
+---
+
+## IX. Auxiliary Modules
+
+| Module | File | Function |
+|--------|------|----------|
+| **ViewRenderer** | `view_renderer.rb` | Tool output formatting (`[OK]`/`[Error]`), parameter truncation, tool activity label generation, Diff stat parsing, thinking text extraction, API Key masking, config menu option building, model form validation |
+| **EntryTracker** | `entry_tracker.rb` | Lightweight ID tracker, maintains tool call stack (push/pop), ensures correct pairing of tool calls and results |
+| **LayoutAdapter** | `layout_adapter.rb` | Layout adapter, provides `clear_output` to clear conversation area |
+| **ProgressHandleAdapter** | `progress_handle_adapter.rb` | Wraps RubyRich progress handler, provides `update` / `finish` / `cancel` interface |
+| **BaseComponent** | `components/base_component.rb` | Component base class, provides shared rendering methods: `muted`/`colored`/`status_marker`/`truncate`/`theme` |
+| **TranscriptPlain** | `extensions/transcript_plain.rb` | Extends Transcript, supports `plain: true` marked plain text entries (for welcome banner, etc.) |
+| **MarkdownTableAdapter** | `extensions/markdown_table_adapter.rb` | Monkey patch extending Kramdown-to-RubyRich table conversion, implementing terminal-width-adaptive table wrapping |
+| **ViewportSelection** | `extensions/viewport_selection.rb` | Extends viewport, supports text selection and multi-platform clipboard copy |
+
+---
+
+## X. Key Rendering Constants
+
+| Constant | Value | Description |
+|----------|-------|-------------|
+| `STREAMING_MARKDOWN_THRESHOLD` | 240 chars | Triggers streaming rendering when exceeded |
+| `STREAMING_MARKDOWN_CHUNK_SIZE` | 6 chars/chunk | Streaming rendering chunk size |
+| `STREAMING_MARKDOWN_DELAY` | 0.03s | Streaming rendering interval |
+| Thinking streaming chunk size | 3 chars/chunk | Thinking content streaming display chunk size |
+| Thinking streaming delay | 0.008s | Thinking content streaming display interval |
+| `SKILL_DESC_MAX` | 50 chars | Skill description truncation length in menu |
+| Tool activity record limit | 12 entries | Max entries in sidebar Work panel |
+| Diff visible lines | 50 lines | Default max display lines for `show_diff` |
+| Tool label truncation | 40 chars | Truncation length for tool call parameter labels |
+
+---
+
+## XI. Source File Listing
+
+```
+lib/clacky/rich_ui/
+├── rich_ui_controller.rb            # Core controller (824 lines)
+├── view_renderer.rb                 # View rendering helper module (291 lines)
+├── entry_tracker.rb                 # Entry ID tracker
+├── layout_adapter.rb                # Layout adapter
+├── progress_handle_adapter.rb       # Progress handler adapter
+├── shell/
+│   └── rich_agent_shell.rb          # AgentShell in Rich mode
+├── components/
+│   ├── base_component.rb            # Base component module
+│   ├── sidebar.rb                   # Sidebar
+│   ├── sidebar_panels.rb            # Sidebar panels (Work/Tasks/Context)
+│   ├── status_view.rb               # Status view (bottom status bar)
+│   ├── thinking_live_view.rb        # Real-time thinking view
+│   └── dialogs/
+│       ├── approval_dialog.rb       # Approval dialog
+│       ├── form_dialog.rb           # Form dialog
+│       └── config_menu_dialog.rb    # Configuration menu dialog
+└── extensions/
+    ├── markdown_table_adapter.rb    # Markdown table adapter
+    ├── transcript_plain.rb          # Plain text transcript extension
+    └── viewport_selection.rb        # Viewport text selection extension
+```
+
+## XII. Lifecycle
+
+1. `RichUIController#initialize` — Initializes configuration, creates `RichAgentShell`, `LayoutAdapter`, `EntryTracker`, binds callbacks
+2. `initialize_and_show_banner` — Sets `running=true`, displays welcome banner or session history
+3. `start` → `start_input_loop` → `@shell.start` — Enters terminal event loop
+4. User submits input → `on_submit` callback → `@input_callback` → CLI → Agent
+5. Agent response → `show_assistant_message` (thinking streaming + Markdown rendering)
+6. Tool calls → `show_tool_call` / `show_tool_result` / `show_tool_error`
+7. Task complete → `show_complete`, updates status bar and sidebar
+8. `stop` — Exits event loop, optional screen clear