docs(readme): add Japanese translation + download section

var-gg · claude · var-gg · commit 6b81f07efe70 · 2026-05-20T15:21:37.000+09:00
- New README.ja.md; the language switcher is now English · 한국어 ·
  日本語 across all three files.
- Add a Download section + release badge linking to the Releases
  page — the README previously documented only building from source,
  leaving non-developer visitors with no path to a binary.
- Bump the stale v0.1 references to v0.2 and rename the version-pinned
  "What v0.1 ships" header to "Features" so it stops rotting.

Co-Authored-By: Claude Opus 4.7 (1M context) &lt;noreply@anthropic.com&gt;
diff --git a/README.ja.md b/README.ja.md
@@ -0,0 +1,126 @@
+# gitwink
+
+[English](README.md) · [한국어](README.ko.md) · **日本語**
+
+[![Release](https://img.shields.io/github/v/release/var-gg/gitwink)](https://github.com/var-gg/gitwink/releases/latest)
+
+> AIエージェント時代のための、トレイ常駐・読み取り専用 git glance。
+
+**ステータス:** v0.2 — 実用段階。コールドスタートに優しいトレイアプリ。
+
+![gitwink](docs/images/hero.gif)
+
+gitwink はシステムトレイに常駐する。クリックすると、**すべて**のローカル
+リポジトリの最近のコミット活動をひと目で確認できる。git **クライアント
+ではない** — commit・push・merge・変更、いずれもできない。設計上、
+読み取り専用。
+
+## ダウンロード
+
+[**最新リリースをダウンロード →**](https://github.com/var-gg/gitwink/releases/latest)
+
+- **Windows** — `.exe`（NSIS インストーラ）または `.msi`
+- **macOS** — `.dmg`（universal）
+
+現時点で成果物は署名されていないため、初回起動時に Windows SmartScreen /
+macOS Gatekeeper が警告を出す — 回避手順はリリースノートに記載。自分で
+ビルドしたい場合は [開発](#開発) を参照。
+
+## なぜ作ったか
+
+以前は VS Code に GitLens を常駐させて生活していた。ブランチグラフ、
+ヒートマップ化された blame、lens のアノテーション — それが *私の* git
+ワークフローだった。そして 2025 年が来た。Cursor、Claude Code、Codex が
+実際の編集をこなすようになり、エディタそのものが任意の存在になった。
+それでも私を VS Code に引き戻す唯一の理由が GitLens だった。
+
+それは無駄に思えた — コミット履歴をちょっと覗くためだけに IDE を丸ごと
+起動するのが。git コマンドはもうエージェントが打つ。私はたまに、何かが
+おかしく見えたときだけ、結果をざっと確認したいだけだ。gitwink は *その*
+ループに合わせた、可能な限り最小のツールだ — トレイアイコンが展開して
+ひと目を提供し、コミットを AI コンテキストとして渡し、そして退く。
+
+commit なし。push なし。merge なし。git の手術が必要なら、エージェント
+に頼む。
+
+## ループ
+
+0.5 秒の確認ループ:
+
+```
+エージェントがコミット  →  トレイをクリック  →  インライン展開  →  "Copy as AI context"
+                                                   →  Claude/Codex に貼り付け
+                                                   →  「エージェントは正しくやったか?」
+```
+
+## 機能
+
+- システムトレイアイコン（Windows トレイ / macOS メニューバー）。
+  クリックでトグル、右クリックで 位置リセット / 設定ファイルを開く /
+  終了。
+- グローバルホットキー `Ctrl+Shift+G`（Windows）/ `Cmd+Shift+G`
+  （macOS）でどこからでもパネルを呼び出し・解除。`settings.json` の
+  `panel_hotkey` を編集すれば変更可能（トレイを右クリック →
+  「Open settings file…」）。Tauri のショートカット仕様なら何でも
+  指定でき、例えば `"Alt+Space"`、`"Ctrl+Alt+Backquote"` など。
+  適用には再起動が必要。
+- 初回起動時にデフォルトのユーザーディレクトリを探索（`source`、
+  `Documents`、`Projects`、`Code`、`Dev`、`repos`、`Desktop`、Windows
+  ではすべての非システムドライブ / macOS では `~/Projects`、`~/Code`、
+  `~/Documents`、`~/Developer`）。結果は
+  `%APPDATA%\gg.var.gitwink\cache.db` の SQLite にキャッシュ。
+- すべてのリポジトリを横断する統合コミットタイムライン。上部のチップ
+  でフィルタ: Repo（検索 + ピン留め）、期間（24h / 3d / 7d / 30d /
+  All）、作成者（カウント付き複数選択）。
+- 行ごとのマーカー — `●` コミット · `◆` マージ · `★` タグ付き。現在
+  チェックアウト中のブランチに無いコミットにはブランチラベルバッジ。
+- 単一リポジトリモード: リポジトリを 1 つ選ぶとパネルがブランチ別
+  ビューに切り替わる。カスタム SVG DAG レーン描画（8 色パレット、
+  ブランチ名からハッシュ生成。main / master / develop はニュートラル色）。
+- クリックでインライン展開: コミットメッセージ本文 + 変更ファイル
+  一覧（NEW/MOD/REN/DEL バッジ、`+/−` 行数、バイナリは `bin` +
+  サイズ、GitLens スタイルのファイル名強調）。
+- 独立した diff ウィンドウ（シングルトン、再利用、位置・サイズ +
+  最大化状態を永続化）でフル表示: ファイルサイドバー + 横スクロール
+  同期の side-by-side diff。PNG / JPG / GIF / WebP / SVG の画像
+  プレビュー内蔵（チェッカー背景、before / after）。ローカルの
+  Git LFS オブジェクトは自動で参照。見つからない場合はインラインで
+  説明。
+- Copy as AI context — `c` キーまたはボタン — コミット、ファイル
+  一覧、（十分小さければ）diff 全体を Markdown ブロックとして出力。
+  Claude / Codex / Cursor にそのまま貼り付け可能。
+
+## Diff ウィンドウ
+
+*「待って、エージェントは本当にそれをやった?」* と思った瞬間のために。
+任意のコミットをクリックすると独立したウィンドウが開く — フルの
+ファイルサイドバー、横スクロール同期の side-by-side diff、バイナリ
+アセットのインライン画像プレビュー、そして 位置・サイズ・最大化状態を
+記憶するシングルトンインスタンス。
+
+![diff window](docs/images/diff.gif)
+
+## 技術スタック
+
+Tauri 2 · Rust · React + TypeScript · `git2` · SQLite · カスタム SVG
+DAG 描画 · テレメトリなし、フォンホームなし、ネットワークなし。
+
+## 開発
+
+```bash
+pnpm install
+pnpm tauri dev
+```
+
+必要環境: Node 20+、Rust stable（Windows では msvc ツールチェーン）、
+Visual C++ Build Tools（Windows）または Xcode CLT（macOS）。
+
+## プラットフォーム
+
+- Windows 10/11 — 主要ターゲット、開発機で検証済み
+- macOS 13+ — 動作するはず、検証は少なめ
+- Linux — 後日
+
+## ライセンス
+
+[MIT](LICENSE)
diff --git a/README.ko.md b/README.ko.md
@@ -1,17 +1,30 @@
 # gitwink
 
-[English](README.md) · **한국어**
+[English](README.md) · **한국어** · [日本語](README.ja.md)
+
+[![Release](https://img.shields.io/github/v/release/var-gg/gitwink)](https://github.com/var-gg/gitwink/releases/latest)
 
 > AI 에이전트 시대를 위한 트레이 상주 · 읽기 전용 git glance.
 
-**상태:** v0.1 — 쓸 만함. cold-start 친화적인 트레이 앱.
+**상태:** v0.2 — 쓸 만함. cold-start 친화적인 트레이 앱.
 
 ![gitwink](docs/images/hero.gif)
 
 gitwink는 시스템 트레이에 산다. 클릭하면 **모든** 로컬 repo의 최근
 커밋 활동을 한눈에 본다. git **클라이언트가 아니다** — commit, push,
 merge, 수정 어느 것도 못 한다. 설계상 읽기 전용.
 
+## 다운로드
+
+[**최신 릴리즈 다운로드 →**](https://github.com/var-gg/gitwink/releases/latest)
+
+- **Windows** — `.exe` (NSIS 인스톨러) 또는 `.msi`
+- **macOS** — `.dmg` (universal)
+
+현재 아티팩트는 서명되지 않아, 첫 실행 시 Windows SmartScreen / macOS
+Gatekeeper가 경고를 띄운다 — 우회 방법은 릴리즈 노트에 있다. 직접
+빌드하려면 [개발](#개발) 참고.
+
 ## 만든 이유
 
 원래 VS Code에 GitLens 박아두고 살았다. 브랜치 그래프, 히트맵
@@ -39,7 +52,7 @@ commit 없음. push 없음. merge 없음. git 수술이 필요하면
                                                    →  "에이전트가 제대로 했나?"
 ```
 
-## v0.1에 들어간 것
+## 기능
 
 - 시스템 트레이 아이콘 (Windows 트레이 / macOS 메뉴바). 클릭으로
   토글, 우클릭으로 위치 리셋 / 설정 파일 열기 / 종료.
diff --git a/README.md b/README.md
@@ -1,17 +1,30 @@
 # gitwink
 
-**English** · [한국어](README.ko.md)
+**English** · [한국어](README.ko.md) · [日本語](README.ja.md)
+
+[![Release](https://img.shields.io/github/v/release/var-gg/gitwink)](https://github.com/var-gg/gitwink/releases/latest)
 
 > Tray-resident, read-only git glance for the AI-agent era.
 
-**Status:** v0.1 — usable. Cold-start friendly tray app.
+**Status:** v0.2 — usable. Cold-start friendly tray app.
 
 ![gitwink](docs/images/hero.gif)
 
 gitwink lives in your system tray. Click it to glance at recent commit
 activity across **all** your local repos. It is **not** a git client — it
 cannot commit, push, merge, or modify anything. Read-only by design.
 
+## Download
+
+[**Download the latest release →**](https://github.com/var-gg/gitwink/releases/latest)
+
+- **Windows** — `.exe` (NSIS installer) or `.msi`
+- **macOS** — `.dmg` (universal)
+
+Artefacts are unsigned for now, so Windows SmartScreen / macOS Gatekeeper
+will warn on first launch — the release notes have the bypass steps.
+Prefer to build it yourself? See [Development](#development).
+
 ## Origin
 
 I used to live in VS Code with GitLens pinned. The branch graph,
@@ -39,7 +52,7 @@ agent commits  →  tray click  →  inline expand  →  "Copy as AI context"
                                                    →  "did the agent do this right?"
 ```
 
-## What v0.1 ships
+## Features
 
 - System tray icon (Windows tray / macOS menu bar) with click-to-toggle
   and right-click Reset position / Open settings file / Quit.
