@akiojin/gwt 9.0.4 → 9.2.0

package/README.ja.md

@@ -1,7 +1,7 @@
 # gwt
 
-gwt は Git worktree の管理と、ブランチ単位での
-`Claude Code` / `Codex` / `Gemini` / `OpenCode` 起動を行うターミナル (TUI) ツールです。
+gwt は Git worktree の管理と、`Claude Code` / `Codex` / `Gemini` /
+`OpenCode` などのコーディングエージェント起動を行うデスクトップ GUI です。
 
 ## インストール
 
@@ -10,25 +10,19 @@ gwt は Git worktree の管理と、ブランチ単位での
 
 ### macOS
 
-インストーラーを実行します。
-
 ```bash
 curl -fsSL https://raw.githubusercontent.com/akiojin/gwt/main/installers/macos/install.sh | bash
 ```
 
-特定バージョンを指定してインストール:
+特定バージョンを指定する場合:
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/akiojin/gwt/main/installers/macos/install.sh | bash -s -- --version 6.30.3
 ```
 
-### Windows
-
-GitHub Releases からバイナリをダウンロードして `PATH` に配置します。
+### Windows / Linux
 
-### Linux
-
-GitHub Releases からバイナリをダウンロードして `PATH` に配置します。
+GitHub Releases からバイナリを取得して `PATH` に配置します。
 
 ### アンインストール（macOS）
 
@@ -36,168 +30,129 @@ GitHub Releases からバイナリをダウンロードして `PATH` に配置
 curl -fsSL https://raw.githubusercontent.com/akiojin/gwt/main/installers/macos/uninstall.sh | bash
 ```
 
-## 使い方
+## 前提
 
-カレントディレクトリで TUI を起動します。
-
-```bash
-gwt
-```
-
-### ターミナル要件
-
-- 256 色対応ターミナル推奨（最新のターミナルはほぼ対応済み）
-- 最小 80x24 のターミナルサイズ
-
-## 使い始め方
-
-1. Git リポジトリ内で `gwt` を実行します。
-2. サイドバーでブランチと worktree を閲覧します。
-3. ブランチ操作欄から次を行います。
-   - worktree の作成/一覧/クリーンアップ
-   - エージェント起動
-4. Agent や要約機能を使う場合は、**Settings** で AI プロファイルを設定します。
-
-## キーバインド
-
-TUI の主要なキーバインドは `Ctrl+G` プレフィックスを使用します。terminal
-text はドラッグ範囲選択した時点で copy されます。
-
-| キーバインド | 操作 |
-|---|---|
-| `Ctrl+G`, `c` | 新しいシェルタブ |
-| `Ctrl+G`, `n` | 新しいエージェントタブ |
-| `Ctrl+G`, `1`-`9` | タブ N に切替 |
-| `Ctrl+G`, `]` | 次のタブ |
-| `Ctrl+G`, `[` | 前のタブ |
-| `Ctrl+G`, `x` | 現在のタブを閉じる |
-| `Ctrl+G`, `w` | Worktree 一覧 |
-| `Ctrl+G`, `s` | 設定 |
-| `Ctrl+G`, `?` | ヘルプ / キーバインド一覧 |
-| `Ctrl+G`, `q` | 終了 |
-
-terminal text はドラッグで copy できます。ホスト terminal が shortcut を
-転送する環境では、次も使えます。
-
-- macOS: `Cmd+C`
-- Linux / Windows: `Ctrl+Shift+C`
-
-シェルやエージェント端末で日本語 IME の候補選択を調査する場合は、
-`GWT_INPUT_TRACE_PATH=/tmp/gwt-input-trace.jsonl` を付けて gwt を起動してください。
-JSONL トレースには、生の `crossterm` キーイベント、keybind 判定、PTY に
-転送したバイト列が記録され、実行中に入力モードを切り替える必要はありません。
-
-その routed trace と terminal の生入力を比較したい場合は、同じ端末で
-`cargo run -p gwt-tui --example keytest -- --mode raw` を実行してください。
-probe は既定で `/tmp/gwt-crossterm-events.jsonl` に全
-`crossterm::event::Event` を記録し、必要なら位置引数で出力先を
-上書きできます。
-
-描画起因の IME 退行を切り分けるため、同じ probe には `--mode redraw` と
-`--mode ratatui` もあります。`redraw` は同じ committed-text surface を
-direct `crossterm` で周期再描画し、`ratatui` は同じ surface を同じ tick
-で ratatui 経由に切り替えます。モード比較時の再描画間隔は
-`--tick-ms <N>` で変更できます。
-
-また gwt は起動時に minimal な kitty keyboard enhancement
-(`DISAMBIGUATE_ESCAPE_CODES | REPORT_ALL_KEYS_AS_ESCAPE_CODES |
-REPORT_ALTERNATE_KEYS | REPORT_EVENT_TYPES`) を要求し、終了時に pop します。
-非対応端末では fail-open で従来挙動を維持します。互換端末で発生する
-繰り返しキーイベントも通常の key press と同じ入力経路に残るため、IME の
-候補ページ送り時にイベントが途中で消えにくくなります。さらに terminal pane
-が focus を持つ間は、overlay など明示的に周期 UI が必要な場合を除いて、
-idle な 100 ms tick では TUI を再描画しないため、バックグラウンド redraw に
-よる IME 候補操作の中断を抑えます。一方で PTY output は即座に redraw を要求
-するため、確定文字や通常の shell 出力が次のキー入力まで遅延しません。
-
-## 必要環境変数と前提
-
-### 必須
-
-- `PATH` に `git` があること（Git コマンドが使える状態）
-
-### 任意
-
-- AI 利用時の認証情報（または Settings のプロファイル設定でも可）:
+- `PATH` 上で `git` が使えること
+- GitHub 連携機能を使う場合は `gh auth login` 済みであること
+- エージェント利用時は必要な API キーを設定すること
   - `ANTHROPIC_API_KEY` または `ANTHROPIC_AUTH_TOKEN`
   - `OPENAI_API_KEY`
   - `GOOGLE_API_KEY` または `GEMINI_API_KEY`
-- `bunx` / `npx`（ローカル起動のフォールバックに利用）
-- gwt が shared project-index runtime を bootstrap / repair するとき
-  （起動時やリポジトリ初期化時など）には `PATH` 上に Python 3.9+ が必要です。
-  gwt が `~/.gwt/runtime/chroma-venv` を自動作成し、その後は managed runtime を再利用します。
-  Windows では Command Prompt / PowerShell で `python` または `py -3` が通る状態にしてください。
-- ベクトル索引データ (Issue / SPEC / ソースファイル) は `~/.gwt/index/<repo-hash>/` 配下に
-  保存されます。Issue および SPEC はリポジトリ単位で共有、ソースファイルは Worktree 単位です。
-  TUI は Worktree ごとにファイルシステム watcher を常駐させ、Issue 索引は起動時に
-  15 分 TTL で非同期リフレッシュします。初回検索時に `intfloat/multilingual-e5-base`
-  埋め込みモデル (約 440MB) を `~/.cache/huggingface/` にダウンロードします。
-  SPEC は `gwt-spec` ラベル付き GitHub Issue として格納され、`~/.gwt/cache/issues/<repo-hash>/` に
-  キャッシュされます。読み取りは `gwt issue spec <n>`、書き込みは
-  `gwt issue spec <n> --edit <section> -f <file>` を使用してください。
-
-### Hook 設定ファイルの扱い
-
-- gwt は `.claude/settings.local.json` をローカル端末向け設定として再生成し、このファイルの Git 除外も管理します。
-- gwt は `.codex/hooks.json` を作成またはマージしますが、`.gitignore` や `info/exclude` には追加しません。
-- `.codex/hooks.json` を version 管理するかどうかは各リポジトリの判断です。既存ファイルがある場合、gwt は gwt 管理 hook だけを置き換え、ユーザー hook と無関係な top-level 設定は保持します。
-
-### GitHub Token（PAT）要件
-
-gwt は GitHub 操作に `gh` CLI を使用します。以下で認証してください:
+- shared project index runtime の bootstrap / repair が必要な場合は
+  Python 3.9+ が使えること
+
+Linux デスクトップ版のビルドには WebKitGTK 系の依存が必要です。CI と同じ依存は
+[docs/docker-usage.md](docs/docker-usage.md) を参照してください。
+
+## 使い方
+
+ネイティブ GUI を起動します。
 
 ```bash
-gh auth login
+gwt
 ```
 
-#### Fine-grained PAT 推奨権限
+起動時には前回の状態を復元するか、新しいプロジェクトディレクトリを開けます。
+同時に WebView 用のローカル HTTP/WebSocket サーバーも起動し、stderr に
+`http://127.0.0.1:<port>/` のような URL を出力します。ネイティブアプリの起動中は、
+同じ URL を通常のブラウザでも開けます。
 
-| 権限 | アクセス | 用途 |
-|---|---|---|
-| **Contents** | Read and Write | リポジトリ参照、ブランチ操作、リリース |
-| **Pull requests** | Read and Write | PR 作成・編集・マージ・レビュー |
-| **Issues** | Read and Write | Issue 作成・編集・コメント |
-| **Metadata** | Read | 暗黙付与 |
+CLI サブコマンドは同じ `gwt` バイナリで処理され、GUI は起動しません。
 
-#### 読み取り専用の最小権限
+```bash
+gwt issue spec 1784 --section plan
+gwt pr current
+gwt board show
+gwt hook workflow-policy
+```
 
-閲覧のみ（PR 作成やブランチ管理なし）の場合:
+## 基本フロー
+
+1. リポジトリを開く、または前回のプロジェクトを復元する
+2. キャンバス上に必要なウィンドウを並べる
+3. `Branches` でブランチを選択し、ダブルクリックで Launch Agent を開く
+4. `Shell` または `Agent` ウィンドウを起動する
+5. `File Tree` でリポジトリを閲覧する
+
+利用できるウィンドウ:
+
+- `Shell`
+- `Agent`
+- `Branches`
+- `File Tree`
+- `Settings`
+- `Memo`
+- `Profile`
+- `Logs`
+- `Issue`
+- `SPEC`
+- `Board`
+- `PR`
+
+`Shell` と `Agent` は実プロセスを持つウィンドウです。`File Tree` は実装済みの
+read-only ツリーです。それ以外は現時点では mock surface です。
+
+## キャンバス操作
+
+- 画面上の zoom ボタンでキャンバスを拡大・縮小
+- 背景ドラッグでキャンバスを移動
+- `Tile` で表示中のウィンドウをグリッド整列
+- `Stack` でタイトルバーを残したまま重ねて表示
+- `Cmd/Ctrl+Shift+Right` と `Cmd/Ctrl+Shift+Left` でフォーカス切替
+  - フォーカスされたウィンドウは中央へ寄ります
+
+## Managed Hook と SPEC キャッシュ
+
+- gwt は `.claude/settings.local.json` を再生成し、`.codex/hooks.json` をマージします
+- SPEC は `gwt-spec` ラベル付き GitHub Issue として管理されます
+- ローカルキャッシュ:
+  `~/.gwt/cache/issues/<repo-hash>/`
+- SPEC 全体を読む:
 
-| 権限 | アクセス |
-|---|---|
-| **Contents** | Read |
-| **Pull requests** | Read |
-| **Issues** | Read |
-| **Metadata** | Read |
+```bash
+gwt issue spec <number>
+```
 
-### 任意（高度設定）
+- セクション単位で読む:
 
-- `GWT_AGENT_AUTO_INSTALL_DEPS` (`true` / `false`)
-- `GWT_DOCKER_FORCE_HOST` (`true` / `false`)
+```bash
+gwt issue spec <number> --section spec|plan|tasks
+```
 
-### ログとプロファイリング
+## ログ
 
-通常ログはプロジェクトごとに `~/.gwt/logs/<repo-hash>/gwt.log.YYYY-MM-DD` へ JSON Lines 形式で保存されます。パフォーマンスプロファイリングは **Settings > Profiling** で有効化できます。
-ログ仕様の詳細は [#1758](https://github.com/akiojin/gwt/issues/1758) を参照してください。
+- アプリログ:
+  `~/.gwt/projects/<repo-hash>/logs/gwt.log.YYYY-MM-DD`
+- セッション状態:
+  `~/.gwt/session.json`
+- プロジェクト単位のワークスペース状態:
+  `~/.gwt/projects/<repo-hash>/workspace.json`
 
 ## 開発
 
 ### ビルド
 
 ```bash
-cargo build -p gwt-tui
+cargo build -p gwt
 ```
 
-### 実行（開発）
+### 実行
 
 ```bash
-cargo run -p gwt-tui
+cargo run -p gwt
+```
+
+### macOS 向け `.app` bundle
+
+```bash
+cargo install cargo-bundle
+cargo bundle -p gwt --format osx
 ```
 
 ### テスト
 
 ```bash
-cargo test -p gwt-core -p gwt-tui
+cargo test -p gwt-core -p gwt --all-features
 ```
 
 ### Lint
@@ -217,12 +172,17 @@ cargo fmt
 ```text
 ├── Cargo.toml          # ワークスペース設定
 ├── crates/
-│   ├── gwt-core/       # コアライブラリ（Git操作・PTY管理・設定）
-│   ├── gwt-github/     # GitHub Issue SOT for SPEC 管理 (SPEC-12)
-│   └── gwt-tui/        # ratatui TUI フロントエンド + CLI (`gwt issue spec ...`)
-└── package.json        # 開発用スクリプト
+│   ├── gwt/            # Desktop GUI + WebView server + CLI dispatch
+│   ├── gwt-core/       # コアライブラリ
+│   └── gwt-github/     # GitHub Issue SPEC cache / update layer
+└── package.json        # npm package metadata and postinstall
 ```
 
+## SPEC
+
+詳細仕様は `gwt-spec` ラベル付き GitHub Issue にあります。ローカルキャッシュ経由で
+`gwt issue spec <n>` を使って確認できます。
+
 ## ライセンス
 
 MIT

package/README.md

@@ -2,8 +2,8 @@
 
 [日本語](README.ja.md)
 
-gwt is a terminal-based (TUI) tool for managing Git worktrees and launching
-coding agents (`Claude Code`, `Codex`, `Gemini`, `OpenCode`) on a project basis.
+gwt is a desktop GUI for managing Git worktrees and launching coding agents
+such as `Claude Code`, `Codex`, `Gemini`, and `OpenCode`.
 
 ## Install
 
@@ -13,8 +13,6 @@ your `PATH`.
 
 ### macOS
 
-Run the installer:
-
 ```bash
 curl -fsSL https://raw.githubusercontent.com/akiojin/gwt/main/installers/macos/install.sh | bash
 ```
@@ -25,11 +23,7 @@ Install a specific version:
 curl -fsSL https://raw.githubusercontent.com/akiojin/gwt/main/installers/macos/install.sh | bash -s -- --version 6.30.3
 ```
 
-### Windows
-
-Download the binary from GitHub Releases and add it to your `PATH`.
-
-### Linux
+### Windows / Linux
 
 Download the binary from GitHub Releases and add it to your `PATH`.
 
@@ -39,169 +33,130 @@ Download the binary from GitHub Releases and add it to your `PATH`.
 curl -fsSL https://raw.githubusercontent.com/akiojin/gwt/main/installers/macos/uninstall.sh | bash
 ```
 
-## Usage
-
-Launch the TUI in the current directory:
+## Requirements
 
-```bash
-gwt
-```
-
-### Terminal requirements
-
-- 256-color terminal recommended (most modern terminals support this)
-- Minimum 80x24 terminal size
-
-## First-time usage
-
-1. Run `gwt` in a Git repository.
-2. Browse branches and worktrees in the sidebar.
-3. Use branch actions to:
-   - create/list/clean worktrees
-   - launch an agent
-4. Open **Settings** to set up AI profile settings if you use Agent or
-   summary features.
-
-## Key bindings
-
-Most TUI key bindings use the `Ctrl+G` prefix. Dragging terminal text copies
-the selection immediately.
-
-| Key binding | Action |
-|---|---|
-| `Ctrl+G`, `c` | New shell tab |
-| `Ctrl+G`, `n` | New agent tab |
-| `Ctrl+G`, `1`-`9` | Switch to tab N |
-| `Ctrl+G`, `]` | Next tab |
-| `Ctrl+G`, `[` | Previous tab |
-| `Ctrl+G`, `x` | Close current tab |
-| `Ctrl+G`, `w` | Worktree list |
-| `Ctrl+G`, `s` | Settings |
-| `Ctrl+G`, `?` | Help / key binding reference |
-| `Ctrl+G`, `q` | Quit |
-
-Drag across terminal text to copy it. When the host terminal forwards the
-shortcut, the platform copy shortcut also works:
-
-- macOS: `Cmd+C`
-- Linux / Windows: `Ctrl+Shift+C`
-
-To investigate Japanese IME candidate selection in a shell or agent terminal,
-launch gwt with `GWT_INPUT_TRACE_PATH=/tmp/gwt-input-trace.jsonl`. The JSONL
-trace records raw `crossterm` key events, keybind decisions, and forwarded PTY
-bytes without adding a runtime input-mode toggle.
-
-To compare that routed trace with raw terminal input, run
-`cargo run -p gwt-tui --example keytest -- --mode raw` in the same terminal.
-The probe logs every raw `crossterm::event::Event` to
-`/tmp/gwt-crossterm-events.jsonl` by default, or to the positional output path
-you pass.
-
-To isolate redraw-related IME regressions, the same probe also supports
-`--mode redraw` and `--mode ratatui`. `redraw` repaints the same committed-text
-surface on a periodic tick using direct `crossterm` commands, while `ratatui`
-uses the same surface through ratatui on the same tick. Use `--tick-ms <N>` to
-change the redraw interval when comparing modes.
-
-gwt also requests minimal kitty keyboard enhancements during terminal startup
-(`DISAMBIGUATE_ESCAPE_CODES | REPORT_ALL_KEYS_AS_ESCAPE_CODES |
-REPORT_ALTERNATE_KEYS | REPORT_EVENT_TYPES`) and pops them on shutdown.
-Unsupported terminals fail open and continue with existing behavior. Repeated
-key events from compatible terminals now stay on the same input path as normal
-key presses, which matters when IME candidate navigation advances to another
-page. While the terminal pane owns focus, idle 100 ms ticks now avoid repainting
-the TUI unless an overlay or other explicit periodic UI surface still needs
-animation, which reduces IME candidate interruption from background redraws.
-PTY output still requests an immediate redraw, so committed text and normal
-shell output are not delayed until the next keypress.
-
-## Environment and requirements
-
-### Required
-
-- `git` command available in `PATH`.
-
-### Optional (depends on use)
-
-- AI provider keys in environment variables (or saved in gwt profile settings):
+- `git` available in `PATH`
+- `gh auth login` completed for GitHub-backed features
+- AI provider credentials when you use agents:
   - `ANTHROPIC_API_KEY` or `ANTHROPIC_AUTH_TOKEN`
   - `OPENAI_API_KEY`
   - `GOOGLE_API_KEY` or `GEMINI_API_KEY`
-- `bunx` or `npx` for local agent launch fallback.
-- Python 3.9+ on `PATH` when gwt needs to bootstrap or repair the shared project-index runtime
-  (for example during startup or repository initialization).
-  gwt bootstraps `~/.gwt/runtime/chroma-venv` automatically, then reuses that managed runtime.
-  On Windows, make sure either `python` or `py -3` works in Command Prompt or PowerShell.
-- Vector index data (SPECs / Issues / source files) is stored under `~/.gwt/index/<repo-hash>/`.
-  Issues and SPECs are repo-scoped and shared across worktrees; source files are worktree-scoped.
-  The TUI runs a per-Worktree filesystem watcher and refreshes the Issue index asynchronously
-  (15-minute TTL) at startup. The first search after a fresh install downloads the
-  `intfloat/multilingual-e5-base` embedding model (~440 MB) into `~/.cache/huggingface/`.
-  SPECs live as GitHub Issues labeled `gwt-spec` and are cached locally at
-  `~/.gwt/cache/issues/<repo-hash>/`; use `gwt issue spec <n>` to read and `gwt issue spec <n> --edit <section> -f <file>` to write.
+- Python 3.9+ when gwt needs to bootstrap or repair the shared project index runtime
 
-### Hook file ownership
+Linux desktop builds also require WebKitGTK-related system packages. See
+[docs/docker-usage.md](docs/docker-usage.md) for the dependency set used in CI.
 
-- gwt regenerates `.claude/settings.local.json` as a local machine file and manages its Git exclusion.
-- gwt creates or merges `.codex/hooks.json`, but does not add it to `.gitignore` or `info/exclude`.
-- Whether `.codex/hooks.json` is version-controlled is a repository decision. When the file already exists, gwt replaces only gwt-managed hook entries and keeps user hooks plus unrelated top-level settings.
-
-### GitHub Token (PAT) requirements
+## Usage
 
-gwt uses `gh` CLI for GitHub operations. Authenticate with:
+Launch the native GUI:
 
 ```bash
-gh auth login
+gwt
 ```
 
-#### Fine-grained PAT recommended permissions
+At startup you can restore the previous session or open a new project
+directory. The app also starts a local HTTP/WebSocket server for the WebView
+surface and prints a URL such as `http://127.0.0.1:<port>/` to stderr. You can
+open that URL in a regular browser while the native app is running.
 
-| Permission | Access | Used for |
-|---|---|---|
-| **Contents** | Read and Write | Repository browsing, branch operations, releases |
-| **Pull requests** | Read and Write | PR create / edit / merge / review |
-| **Issues** | Read and Write | Issue create / edit / comment |
-| **Metadata** | Read | Implicitly granted |
+CLI subcommands run in the same binary without opening a GUI window:
 
-#### Read-only minimum
+```bash
+gwt issue spec 1784 --section plan
+gwt pr current
+gwt board show
+gwt hook workflow-policy
+```
 
-For browse-only usage (no PR creation or branch management):
+## Main Workflow
+
+1. Open a repository directory or restore the previous project.
+2. Use the canvas to arrange floating windows.
+3. Open `Branches`, select a branch, and double-click to open Launch Agent.
+4. Start `Shell` or `Agent` windows on the selected branch/worktree.
+5. Inspect the repository with the read-only `File Tree` window.
+
+Available windows include:
+
+- `Shell`
+- `Agent`
+- `Branches`
+- `File Tree`
+- `Settings`
+- `Memo`
+- `Profile`
+- `Logs`
+- `Issue`
+- `SPEC`
+- `Board`
+- `PR`
+
+`Shell` and `Agent` are live process windows. `File Tree` is a live read-only
+tree view. The remaining windows are currently mock surfaces where production
+behavior has not been wired yet.
+
+## Canvas Operations
+
+- Zoom the canvas with the on-screen zoom buttons
+- Pan the canvas by dragging the background
+- Use `Tile` to arrange windows on a grid
+- Use `Stack` to cascade windows with overlap
+- Use `Cmd/Ctrl+Shift+Right` and `Cmd/Ctrl+Shift+Left` to cycle focus; the
+  focused window is recentered
+
+## Managed Hooks and SPEC Cache
+
+- gwt regenerates `.claude/settings.local.json` and merges `.codex/hooks.json`
+  for managed hooks
+- SPECs are stored as GitHub Issues labeled `gwt-spec`
+- Local cache path:
+  `~/.gwt/cache/issues/<repo-hash>/`
+- Read a SPEC:
 
-| Permission | Access |
-|---|---|
-| **Contents** | Read |
-| **Pull requests** | Read |
-| **Issues** | Read |
-| **Metadata** | Read |
+```bash
+gwt issue spec <number>
+```
 
-### Optional advanced toggles
+- Read one section:
 
-- `GWT_AGENT_AUTO_INSTALL_DEPS` (`true` / `false`)
-- `GWT_DOCKER_FORCE_HOST` (`true` / `false`)
+```bash
+gwt issue spec <number> --section spec|plan|tasks
+```
 
-### Logging and profiling
+## Logs
 
-Normal logs are stored per project as JSON Lines under `~/.gwt/logs/<repo-hash>/gwt.log.YYYY-MM-DD`. Performance profiling can be enabled in **Settings > Profiling**.
-See [#1758](https://github.com/akiojin/gwt/issues/1758) for the logging specification.
+- App logs:
+  `~/.gwt/projects/<repo-hash>/logs/gwt.log.YYYY-MM-DD`
+- Session state:
+  `~/.gwt/session.json`
+- Project workspace state:
+  `~/.gwt/projects/<repo-hash>/workspace.json`
 
 ## Development
 
 ### Build
 
 ```bash
-cargo build -p gwt-tui
+cargo build -p gwt
 ```
 
-### Run (development)
+### Run
 
 ```bash
-cargo run -p gwt-tui
+cargo run -p gwt
+```
+
+### Build a macOS app bundle
+
+```bash
+cargo install cargo-bundle
+cargo bundle -p gwt --format osx
 ```
 
 ### Test
 
 ```bash
-cargo test -p gwt-core -p gwt-tui
+cargo test -p gwt-core -p gwt --all-features
 ```
 
 ### Lint
@@ -216,17 +171,22 @@ cargo clippy --all-targets --all-features -- -D warnings
 cargo fmt
 ```
 
-## Project structure
+## Project Structure
 
 ```text
 ├── Cargo.toml          # Workspace configuration
 ├── crates/
-│   ├── gwt-core/       # Core library (Git operations, PTY management, config)
-│   ├── gwt-github/     # GitHub Issue SOT for SPEC management (SPEC-12)
-│   └── gwt-tui/        # ratatui TUI frontend + CLI dispatch (`gwt issue spec ...`)
-└── package.json        # Development scripts
+│   ├── gwt/            # Desktop GUI + WebView server + CLI dispatch
+│   ├── gwt-core/       # Core library
+│   └── gwt-github/     # GitHub Issue SPEC cache / update layer
+└── package.json        # npm package metadata and postinstall
 ```
 
+## Specs
+
+Detailed requirements live in GitHub Issues labeled `gwt-spec`. Use
+`gwt issue spec <n>` to inspect them locally through the cache-backed CLI.
+
 ## License
 
 MIT

package/bin/gwt.cjs

@@ -13,7 +13,7 @@ const os = require("os");
 
 const REPO = "akiojin/gwt";
 const BIN_DIR = __dirname;
-const BIN_NAME = process.platform === "win32" ? "gwt-tui.exe" : "gwt-tui";
+const BIN_NAME = process.platform === "win32" ? "gwt.exe" : "gwt";
 const BIN_PATH = path.join(BIN_DIR, BIN_NAME);
 
 function releaseAssetName() {

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@akiojin/gwt",
-  "version": "9.0.4",
-  "description": "TUI for Git worktree management and coding agent launch",
+  "version": "9.2.0",
+  "description": "Desktop GUI for Git worktree management and coding agent launch",
   "type": "module",
   "bin": {
     "gwt": "bin/gwt.cjs"
   },
   "scripts": {
     "postinstall": "node scripts/postinstall.js",
-    "dev": "cargo run -p gwt-tui",
-    "build": "cargo build --release -p gwt-tui",
-    "test": "cargo test -p gwt-core -p gwt-tui --all-features",
+    "dev": "cargo run -p gwt",
+    "build": "cargo build --release -p gwt",
+    "test": "cargo test -p gwt-core -p gwt --all-features",
     "test:all": "bash scripts/test-all.sh",
     "prepare": "test -n \"$CI\" || bunx husky install",
     "lint:skills": "bash scripts/validate-skill-frontmatter.sh",

package/rustfmt.toml

@@ -3,6 +3,4 @@ edition = "2021"
 max_width = 100
 tab_spaces = 4
 use_small_heuristics = "Default"
-imports_granularity = "Crate"
-group_imports = "StdExternalCrate"
 reorder_imports = true