fpasoterm 1.6.0

package/INSTALL.md

@@ -0,0 +1,229 @@
+# Installation
+
+Japanese version: [INSTALL.ja.md](INSTALL.ja.md).
+
+## npm
+
+After the package is published, install the command from the npm registry:
+
+```sh
+npm install -g fpasoterm
+fpasoterm
+```
+
+If your network makes npm's automatic audit request noisy, use `--no-audit` for local installs. CI still runs the explicit security checks in this repository.
+Check which version and build commit are on the command path:
+
+```sh
+fpasoterm --version
+fpasoterm -v
+```
+
+On Windows, run `fpasoterm --version` after installing a newer `.exe` or `.msi`. If it still prints the old version, the old executable is still being launched from `Path`, the Start menu, or a pinned shortcut. Close running fpasoterm windows, install the newer package again, then start fpasoterm from the updated shortcut.
+
+Windows builds place `fpasoterm.cmd` beside the release executable. Use this
+console wrapper for `--version`, `--plugin-path`, `--plugin-info`, and other
+CLI-only operations; it runs the executable directly so stdout, stderr, and
+the exit code return to PowerShell or cmd. Normal launches remain detached:
+
+```powershell
+.\src-tauri\target\release\fpasoterm.cmd --version
+.\src-tauri\target\release\fpasoterm.cmd --plugin-path
+.\src-tauri\target\release\fpasoterm.cmd --help
+.\src-tauri\target\release\fpasoterm.cmd
+```
+
+PowerShell command completion is available from the same wrapper:
+
+```powershell
+.\src-tauri\target\release\fpasoterm.cmd --completion powershell | Out-String | Invoke-Expression
+```
+
+For Bash, Zsh, Fish, persistent setup, and the Windows limitations of
+`cmd.exe`, see [Command Completion](docs/completion.en.md).
+
+## Development Build
+
+Linux development requires the Tauri/WebKitGTK system packages:
+
+```sh
+sudo apt install build-essential curl libgtk-3-dev libwebkit2gtk-4.1-dev libayatana-appindicator3-dev librsvg2-dev
+```
+
+```sh
+npm install
+./scripts/run
+```
+
+For quick behavior checks while developing, use the Tauri dev runtime:
+
+```sh
+./bin/fpasoterm --dev
+```
+
+This does not create release bundles. It also ignores an existing `src-tauri/target/release/fpasoterm`, so renderer and Tauri source changes are reflected without reinstalling the desktop entry.
+Add `--foreground --console-diagnostics` only when you need logs in the current console.
+The first `--dev` launch may still take a few minutes because Cargo has to create the Tauri debug binary. Later launches reuse that build cache.
+
+Install a local `fpasoterm` command for this checkout:
+
+```sh
+npm run install:desktop
+fpasoterm
+```
+
+The command is written to `~/.local/bin/fpasoterm` unless `XDG_BIN_HOME` is set.
+
+Update an existing local command, launcher entry, and icon installation:
+
+```sh
+npm run update:desktop
+```
+
+Update an npm-installed package from the terminal:
+
+```sh
+fpasoterm --self-update
+```
+
+For a source checkout, update the checkout with your normal git or jj workflow,
+then refresh the installed command, launcher entry, and icons:
+
+```sh
+fpasoterm --update-desktop
+```
+
+For a clean non-jj git checkout, this can be automated:
+
+```sh
+fpasoterm --self-update-checkout
+```
+
+Run `npm run update:desktop` after changing the checkout path, launcher icon,
+installed command wrapper, Rust source, or renderer assets. It overwrites the
+desktop launcher and rebuilds the local runtime so the next icon or command
+launch uses the current checkout. It is not required for `./bin/fpasoterm --dev ...`.
+
+`npm run update:desktop` is for Linux and ChromeOS desktop integration. On
+Windows it intentionally makes no desktop changes; update by installing the
+current `.msi` or `.exe` artifact instead.
+
+To remove an npm global installation, including its npm-managed `fpasoterm`
+command, run:
+
+```sh
+npm uninstall -g fpasoterm
+```
+
+This does not remove a source-checkout desktop launcher, user config, cache, or
+app data. If `type -a fpasoterm` still shows a command afterward, it is another
+installation such as a source-checkout launcher.
+
+On Windows, run the same command in PowerShell or Command Prompt. Open a new
+terminal afterward, then use `where.exe fpasoterm` or
+`Get-Command fpasoterm -All` to check for another remaining command.
+
+From a source checkout, remove its local command, desktop launcher entry,
+installed launcher icons, user config, runtime cache, and Tauri/WebKit app data:
+
+```sh
+npm run uninstall:desktop
+```
+
+On Windows, `npm run uninstall:desktop` only removes fpasoterm-specific
+directories from the current user's `Path` if they were added during local
+testing. It does not remove the global npm package, source checkout, user
+config, cache, or app data. Shared npm directories are left untouched.
+
+To remove both installation types, run `npm run uninstall:desktop` from the
+source checkout first, then run `npm uninstall -g fpasoterm`.
+
+To expose the local command during development:
+
+```sh
+npm link
+fpasoterm
+```
+
+If ChromeOS/Baguette shows black, white, or flickering surfaces during transparency testing, start with:
+
+```sh
+fpasoterm --disable-dmabuf
+```
+
+## Release Artifacts
+
+To create artifacts for the current development machine:
+
+```sh
+npm run build:artifacts
+```
+
+Generated files are written to `artifacts/`. Source archives are always generated. Platform bundles depend on the current OS, so a local Linux build creates Linux packages only.
+
+Tagged GitHub Releases build the broader release set in GitHub Actions:
+
+- source package and portable source archive
+- Linux x64 `.deb` / `.rpm`
+- Linux arm64 `.deb` / `.rpm` for ChromeOS/Baguette and other arm64 Linux environments
+- macOS x64 bundle
+- macOS arm64 bundle
+- Windows x64 bundle and `fpasoterm-<version>-windows-cli.cmd` console wrapper
+
+Install the Debian package locally:
+
+```sh
+sudo apt install ./artifacts/fpasoterm_1.3.0_arm64-linux-arm64.deb
+```
+
+## Linux Desktop Entry
+
+The desktop entry template is:
+
+```text
+extra/linux/io.github.oyoguhito.fpasoterm.desktop
+```
+
+The application icon is:
+
+```text
+extra/logo/fpasoterm.png
+```
+
+For macOS app bundles, use:
+
+```text
+extra/macos/fpasoterm.icns
+```
+
+For Windows app bundles, use:
+
+```text
+extra/windows/fpasoterm.ico
+```
+
+Install the desktop entry and hicolor launcher icons into the current user's data directory:
+
+```sh
+npm run install:desktop
+```
+
+For unpacked checkout installs, the installed desktop entry rewrites `Exec=` to
+the absolute `~/.local/bin/fpasoterm` wrapper path and does not set `TryExec`.
+The wrapper records the Node.js executable used during installation and also
+falls back to common `node` paths. This avoids ChromeOS launcher failures when
+the launcher environment does not include the user's shell `PATH`.
+
+The installed desktop entry uses `StartupWMClass=fpasoterm` and
+`Icon=io.github.oyoguhito.fpasoterm`. The GTK application id is disabled so
+multiple fpasoterm windows can be started from the CLI or launcher while the
+launcher still resolves the fpasoterm shelf icon and hover name. The installer
+writes both `io.github.oyoguhito.fpasoterm.png` and `fpasoterm.png` icon names
+into the hicolor icon theme.
+
+Regenerate launcher icon sizes after replacing `extra/logo/fpasoterm.png`:
+
+```sh
+npm run generate:icons
+npm run update:desktop
+```

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 oyoguhito
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ja.md

@@ -0,0 +1,389 @@
+# fpasoterm
+
+![fpasoterm logo](extra/logo/fpasoterm.png)
+
+英語版: [README.md](README.md)。インストール手順は[日本語](INSTALL.ja.md)と[English](INSTALL.md)を参照してください。
+
+fpasoterm は Tauri、xterm.js、Rust PTY bridge を使った Terminal アプリです。ChromeOS Linux での日本語入力を重視しつつ、将来的に他 OS へ展開しやすい構成にしています。
+
+screen / tmux / byobu / zellij / herdr などの terminal multiplexer と併用する前提です。fpasoterm 自身では画面分割を行いませんが、titlebar の `Tile` button で複数 window を並べられます。
+
+これは意図した責務境界です。pane / session管理、shell command、job control、multiplexer設定に加え、Vim、Emacs、Fresh、Helix などの TUI editor が提供する編集機能も、原則として再実装しません。これらの workflow は shell、multiplexer、TUI editor へ委ね、fpasoterm は terminal surface、OS integration、local customization hook を担当します。追加すると便利な挙動は、原則として本体を肥大化させず plugin として提供します。一方で、これらの multiplexer と TUI editor を問題なく利用できる互換性の維持・改善は優先します。
+
+fpasoterm は `かな` / `英数` キーを横取りしません。日本語入力の切替と composition は OS webview と xterm.js に任せます。
+
+IME、描画、clipboard、window問題を再現して確認する手順は
+[デバッグガイド](docs/debugging.ja.md)を参照してください。
+
+window menu の `Font / Glyph Test` では、使用中のterminal font設定とCJK、半角カナ、罫線、記号、Nerd Font glyphを確認できます。詳細は[Font / Glyph Diagnostics](docs/font-diagnostics.ja.md)を参照してください。
+
+window menu の `Diagnostics > Capability Test` では、terminal environmentとtruecolor、OSC 52、OSC 8、OSC 9/99、OSC 7、OSC 133、bracketed paste、bellの対応状況を確認できます。同じpanelで次回のterminal session用にUTF-8、Shift_JIS、EUC-JPのoutput decoderも保存できます。詳細は[Terminal Capability Diagnostics](docs/capability-diagnostics.ja.md)を参照してください。
+
+shellがOSC 7でlocal current directoryを通知している場合、`Ctrl+Shift+o`または**Window > New CWD**で同じdirectoryから別のfpasoterm windowを開けます。
+
+terminal outputのURLとOSC 8 hyperlinkは明示的な確認dialogを表示します。URLは常にcopyでき、外部browserでopenするには`[security] osc8Open = true`も必要です。absolute pathはcopy-only linkです。
+
+## 必要な環境
+
+詳細な導入手順は [INSTALL.ja.md](INSTALL.ja.md) を参照してください。ChromeOS Linux で開発する場合は、Node.js、Rust、および Tauri/WebKitGTK 用の system package が必要です。
+
+## 起動
+
+起動:
+
+```sh
+npm install
+./scripts/run
+```
+
+リリース用 bundle を作らず、まず起動だけ確認する場合:
+
+```sh
+./bin/fpasoterm --dev
+```
+
+この起動方法は古い `src-tauri/target/release/fpasoterm` が存在していても無視し、localhost の開発serverを使わないdebug binaryで現在のsourceを使います。
+現在のコンソールでログを見たい場合だけ `--foreground --console-diagnostics` を追加してください。
+
+shell で `exit` を実行すると fpasoterm のウィンドウも閉じます。
+
+## コマンドラインオプション
+
+cached runtime を使用する通常起動ではコンソールから切り離して起動し、すぐに shell prompt が戻ります。
+
+```sh
+fpasoterm
+```
+
+source checkoutまたはnpm packageの初回起動でlocal Cargo buildが必要な場合は、CLIを接続したまま`phase 1/3`の準備、`phase 2/3`のcompiler progress、`phase 3/3`のnative window起動を表示します。Cargo errorもこのterminalへ表示し、window process起動後にpromptが戻ります。runtime解決、Cargo build、desktop spawnの経過時間とcompiler outputはLinux/macOSでは`~/.cache/fpasoterm/launcher.log`、Windowsでは`%LOCALAPPDATA%\\fpasoterm\\launcher.log`にも記録します。desktop processの終了まで待機したい場合だけ、`--foreground --console-diagnostics`を使ってください。
+
+オプション一覧:
+
+```sh
+fpasoterm --help
+```
+
+Bash、Zsh、Fish、PowerShellではcommand completionを使えます。例えば現在の
+Bash shellで有効にするには次を実行します。
+
+```bash
+source <(fpasoterm --completion bash)
+```
+
+永続的な導入とWindows PowerShellの手順は[コマンド補完](docs/completion.ja.md)を参照してください。アプリ更新後に新しいCLI optionをTab補完へ反映したい場合だけ、使用するshellに対して永続completionを再導入します。
+
+起動せずに version を確認:
+
+```sh
+fpasoterm --version
+fpasoterm -v
+fpasoterm --update-check
+fpasoterm --doctor
+```
+
+GUIではhamburger menuから**Help**を開き、**Check for Updates**を選択します。同じpanelに現在のbuild、npmの最新版、更新状況が表示されます。Helpを開いただけでは通信しません。
+
+`--update-check` はnpmの`latest` releaseを明示的に問い合わせ、更新の有無を表示します。起動時、`--help`、`--version`では自動実行しません。
+
+`--doctor`はread-onlyの保守reportです。Node launcherでは選択中のconfig、npm latest、`npm audit --omit=dev`を確認し、更新が必要な場合も`--self-update`を案内するだけで自動更新はしません。standalone binaryではconfigと更新情報を確認し、npm package contextが無いためnpm auditは`unavailable`として表示します。
+
+一時的な設定上書き:
+
+```sh
+fpasoterm --config ~/.config/fpasoterm/User/work.toml
+fpasoterm --size 1200x760
+fpasoterm --width 1200 --height 760
+fpasoterm --shell /bin/fish
+fpasoterm --cwd .
+fpasoterm --cwd ~/work/project --title project
+fpasoterm --command "tmux attach -t work"
+fpasoterm --title work --titlebar-color '#2e7d32'
+```
+
+よく使う一時指定には短縮形も使えます。
+
+```sh
+fpasoterm -t work -b '#2e7d32' -z 1200x760 -s /bin/fish -o .
+fpasoterm -e "tmux attach -t work"
+```
+
+起動中の window は、POSIX shell を使っている場合は terminal 内の command からも変更できます。
+
+```sh
+printf '\033]0;work\a\r\n'
+printf '\033]777;titlebarColor=#2e7d32\a\r\n'
+printf '\033]777;opacity=0.65\a\r\n'
+printf '\033]777;title=work;titlebarColor=#2e7d32\a\r\n'
+```
+
+Windows PowerShell や cmd.exe では、この `printf` 例はそのまま使えません。
+PowerShell 形式、または下記 helper script を使ってください。
+
+```powershell
+[Console]::Write("$([char]27)]777;title=work;titlebarColor=#2e7d32$([char]7)`r`n")
+```
+
+runtime config sample は次で適用できます。
+
+```sh
+./examples/apply-runtime-appearance.sh
+```
+
+Windows PowerShell または cmd.exe では次を使えます。
+
+```powershell
+.\examples\apply-runtime-appearance.ps1
+.\examples\apply-runtime-appearance.bat
+```
+
+この sample は title を `RUNTIME SAMPLE ACTIVE` にし、titlebar をピンク、
+terminal 背景と文字色を分かりやすく変更します。
+
+起動中の window を標準の見た目へ戻す場合:
+
+```sh
+./examples/apply-default-appearance.sh
+```
+
+Windows PowerShell または cmd.exe では次を使えます。
+
+```powershell
+.\examples\apply-default-appearance.ps1
+.\examples\apply-default-appearance.bat
+```
+
+path を手動指定する場合:
+
+```sh
+config_path="$(pwd)/examples/config/runtime-appearance.toml"
+printf '\033]777;config=%s\a\r\n' "$config_path"
+```
+
+Windows PowerShell で path を手動指定する場合:
+
+```powershell
+$configPath = Resolve-Path .\examples\config\runtime-appearance.toml
+[Console]::Write("$([char]27)]777;config=$configPath$([char]7)`r`n")
+```
+
+runtime config 適用では、現在の shell session は維持されます。
+`window.title`、`window.titlebarColor`、`window.width`、`window.height`、
+`terminal.fontSize`、`terminal.lineHeight`、`terminal.fontFamily`、`terminal.backgroundOpacity`、`terminal.theme` など、起動中に反映可能な表示設定を適用します。
+`terminal.shell` のように新しい PTY が必要な設定は次回起動時に反映されます。
+
+起動せずに解決済み設定と plugin 読み込み状況を確認:
+
+```sh
+fpasoterm --show-config
+fpasoterm --config ~/.config/fpasoterm/User/work.toml --show-config
+```
+
+windowを開かずに設定を検証し、Issue向けMarkdown reportを作成する場合:
+
+```sh
+fpasoterm --config-check
+fpasoterm --doctor
+fpasoterm --diagnostics
+fpasoterm --copy-diagnostics
+fpasoterm --open-log-dir
+```
+
+出力内容、exit status、clipboard要件は[設定と診断](docs/diagnostics.ja.md)を参照してください。
+
+名前付きの表示・shell profileを一回の起動だけ使う場合は
+`fpasoterm --profile <name>`を使用します。詳細は[Profile](docs/config.ja.md#profile)を参照してください。
+
+起動中のwindowを新しいwindowを開かずに一覧表示:
+
+```sh
+fpasoterm --list
+fpasoterm -l
+```
+
+各行にprocess/session ID、表示title、起動時刻を表示します。
+
+process ID、表示titleの完全一致、または予約targetの`all`で起動中のwindowを閉じます:
+
+```sh
+fpasoterm --close 12345
+fpasoterm -q review-shell
+fpasoterm --close all
+```
+
+Windows の packaged `fpasoterm.exe` を直接起動した場合、`--show-config` は
+解決済み runtime config を JSON で出力します。Node launcher を使える場合は
+TOML と plugin load detail を表示します。
+Windows で古い installer から上書き更新した後は `fpasoterm --version` を確認してください。
+古い UI が表示され、かつ `--version` も古い version を返す場合、`Path`、Start menu、pinned shortcut のいずれかが古い executable を起動しています。起動中の fpasoterm を閉じ、新しい installer を再実行してから更新後の shortcut で起動してください。
+
+`config.toml` の plugin を有効化・無効化:
+
+```sh
+fpasoterm --enable-plugin hello,theme
+fpasoterm --disable-plugin hello,theme
+```
+
+plugin enable/disable command は Node launcher が処理します。packaged binary
+を直接起動している場合は、`config.toml` を手動編集するか、npm install された
+`fpasoterm` command を使ってください。
+
+デバッグ時にコンソールへ接続したまま起動する場合:
+
+```sh
+fpasoterm --foreground --console-diagnostics
+```
+
+source checkout で動作だけ確認する場合:
+
+```sh
+./bin/fpasoterm --dev
+```
+
+ChromeOS/Baguette で透過や描画が不安定な場合:
+
+```sh
+fpasoterm --disable-dmabuf
+```
+
+## 設定とプラグイン
+
+fpasoterm は以下の設定を読み込みます。
+
+```text
+~/.config/fpasoterm/User/config.toml
+```
+
+初回起動時には以下にサンプルを書き出します。
+
+```text
+~/.config/fpasoterm/User/config.toml.example
+```
+
+例:
+
+```toml
+[terminal]
+fontSize = 15
+lineHeight = 1
+fontFamily = "Noto Sans Mono CJK JP, monospace"
+
+[plugins]
+enabled = ["plugins/example.ts"]
+```
+
+プラグインは `~/.config/fpasoterm/User/plugins/` 配下に置きます。JavaScript (`.js`) と TypeScript (`.ts`) に対応しています。TypeScript plugin は起動時に `~/.config/fpasoterm/User/cache/plugins/` へ変換されます。plugin は renderer context で動作するため、内容を確認した信頼できるローカル file だけを有効にしてください。pluginとsync folderの信頼境界は[セキュリティ](docs/security.ja.md)を参照してください。
+
+plugin は `version` を参照し、`onReady()` で起動後の処理を登録し、`registerCommand()` で hamburger menu の `Plugins` submenu に action を追加できます。`fpasoterm --plugin-list` でlocalの `User/plugins` にある検出済み・有効な plugin を確認し、`--plugin-enable` / `--plugin-disable` で有効 list を更新できます。`--plugin-info welcome-banner`ではsource、有効状態、description、load statusを確認できます。有効化またはsource変更後は対象windowを再起動してください。
+
+review済みのlocal pluginとそのenabled entryを削除する場合は`fpasoterm --plugin-uninstall <file>`を使用します。これはlocal-onlyの操作であり、公開port catalogへは接続しません。
+
+ports repository全体をcloneせず、Node.jsも使わずにreview済み公開pluginを取得する場合は、`fpasoterm --plugin-install appearance/teal`を実行します。内容確認後に有効化する場合だけ`--enable`を追加します。固定repository、検証、上書き条件は[プラグイン](docs/plugins.ja.md)を参照してください。
+
+review済みのlocal `fpasoterm-plugins` checkoutからは、`fpasoterm --plugin-install appearance/teal --plugin-ports-dir ./fpasoterm-plugins --enable`を使用します。単独の信頼済みsource fileは`fpasoterm --plugin-install-file ./my-plugin.ts --enable`でcopyできます。ports projectはcatalog / INDEX検索とplugin開発・検証用で、利用者向けのinstallはfpasoterm本体が行います。
+
+`fpasoterm --plugin-search [query]`はpluginを導入せず、公開port metadataだけを検索します。各結果にはcopyして使える`--plugin-install` commandとremote公式`INDEX`であるsourceを表示します。`--plugin-list`はlocal-onlyであり、networkには接続しません。
+
+最小の TypeScript plugin:
+
+```ts
+/// <reference path="/path/to/fpasoterm/docs/fpasoterm-plugin.d.ts" />
+
+const api = window.fpasotermPluginApi;
+api.log('example plugin loaded');
+api.terminal.options.cursorBlink = true;
+```
+
+IME composition は表示専用です。WebView/xterm.js の入力経路で受け取った文字を、fpasoterm が抑止・再送・置換・直接確定することはありません。
+
+全デフォルト設定は [設定](docs/config.ja.md) にまとめています。plugin runtime/API contractは [プラグイン](docs/plugins.ja.md)、対応 API declarationは [`docs/fpasoterm-plugin.d.ts`](docs/fpasoterm-plugin.d.ts) を参照してください。設定 sample は [examples/config](examples/config)、最小のlocal plugin sampleは [examples/plugins](examples/plugins) にあります。review済みの公開pluginは、ports catalog、compatibility check、update、contribution workflowを管理する [fpasoterm-plugins](https://github.com/oyoguhito/fpasoterm-plugins) を使用してください。
+
+複数端末間のメンテナンス用途では、Google Drive for desktop などのローカル同期フォルダを使って、diagnostics と terminal output log を共有できます。Google Drive API や OAuth は使いません。詳細は [Sync Folder](docs/sync.ja.md) を参照してください。
+Kitty Graphics Protocol、SIXEL、iTerm inline image は、image stream により Tauri/WebKitGTK renderer が停止することがあるため、現在は未対応です。`Ctrl+Shift+B` の Broadcast Input は対象の local fpasoterm window を選択して同じ command を送信できます。`fpasoterm --broadcast "command"` でも同じ操作を実行でき、trusted な同期フォルダを使う場合は別 machine で既に起動している全 instance にも短寿命 command を送れます。詳細は [設定](docs/config.ja.md) と [Sync Folder](docs/sync.ja.md) を参照してください。
+初回設定は `fpasoterm --setup-sync` で質問に答えるだけで作成できます。
+Windows の source checkout では `node .\bin\fpasoterm --setup-sync` を使います。
+`fpasoterm --sync-status` で folder health と channel を確認でき、`fpasoterm --sync-clean` は期限切れの sync command file だけを削除します。
+terminal output log は hamburger menu の `Log Start (^S)` / `Log Stop (^S)` または `Ctrl+Shift+S` で取得し、`Log Show (^P)` または `Ctrl+Shift+P` で active log または `Log Stop` で閉じた最後の log を表示できます。共有したい場合は `logging.directory` を同期フォルダに向けます。
+log panel には検索欄と `Search` ボタンがあり、表示中の log から次の一致文字列を選択してその位置へ scroll できます。`N` は次、`P` は前の一致箇所へ移動します。log text area に focus がある場合は `j` / `k` でも同じ移動ができ、矢印キーは通常の log scroll に使えます。
+
+npm registry から global install する場合:
+
+```sh
+npm install -g fpasoterm
+fpasoterm
+```
+
+開発中に link する場合:
+
+```sh
+npm link
+fpasoterm
+```
+
+または:
+
+```sh
+npm install -g .
+fpasoterm
+```
+
+診断:
+
+```sh
+FPASOTERM_DEBUG_KEYS=1 ./scripts/run
+cat ~/.config/fpasoterm/User/logs/fpasoterm-debug.log
+```
+
+アイコンを変更する場合は `extra/logo/fpasoterm.png` を差し替え、以下を実行します。
+
+```sh
+npm run generate:icons
+npm run install:desktop
+```
+
+ChromeOS Linux launcher は `extra/linux/icons/hicolor/` に生成されるサイズ別 PNG を使います。Android native package を作る場合は、この PNG を adaptive icon の元画像として使います。
+
+## アイコン
+
+project icon は `extra/logo/fpasoterm.png` です。Linux/ChromeOS launcher は `extra/linux/icons/hicolor/` の icon theme file を使います。macOS bundle は `extra/macos/fpasoterm.icns`、Windows bundle は `extra/windows/fpasoterm.ico` を使います。
+
+## ライセンス
+
+MIT。詳細は [LICENSE](LICENSE) を参照してください。
+
+## コントリビュート
+
+[CONTRIBUTING.ja.md](CONTRIBUTING.ja.md) を参照してください。英語版は
+[CONTRIBUTING.md](CONTRIBUTING.md)です。release 履歴は [CHANGELOG.md](CHANGELOG.md) に記録します。
+
+## jj repository 初期化
+
+`main` bookmark は空の initial commit を指します。初期化は次を実行します。
+
+```sh
+cd fpasoterm
+./scripts/init-jj-empty-main
+```
+
+## チェック
+
+```sh
+npm run check
+npm run scan:secrets
+desktop-file-validate extra/linux/io.github.oyoguhito.fpasoterm.desktop
+npm run audit:prod
+```
+
+GitHub Actions は push と pull request で同じ check と Linux artifact build を実行します。正式な cross-platform artifact は tag-based Release workflow で生成します。
+
+## ドキュメント
+
+- [仕様](docs/spec.ja.md)
+- [設定](docs/config.ja.md)
+- [Sync Folder](docs/sync.ja.md)
+- [Pull request review](docs/pr-review.ja.md)
+- [デバッグガイド](docs/debugging.ja.md)
+- [リリースチェックリスト](docs/release-checklist.ja.md)
+- [既知課題](docs/known-issues.ja.md)
+### SSHFS mount
+
+`Sync > SSHFS Mounts`からremote directoryを`User/mounts/<name>`へmountできます。既定では通常のSSH key、config、agentを使い、任意のpasswordはそのmount時だけ使用して保存しません。詳細は[SSHFS mount](docs/sshfs.ja.md)を参照してください。