複数のローカル git リポジトリを一元管理する Tauri v2 製デスクトップアプリ。
- Header — dsx の版・workspace root を表示し、Scan / Fetch All / dsx sys update / Daily Refresh(
dsx run --root)を実行 - Repository Status — 全リポジトリの状態(ahead / behind / dirty / detached / no upstream)をカードで俯瞰し、要対応のリポジトリを先頭に提示。リポジトリごとの Fetch とフォルダを開く操作。「Remote を確認」で、各リポジトリの origin を GitHub に問い合わせ、アーカイブ済み・移転・見つからないクローンをバッジで示す(
ghを使う。削除は、Arbor では行わない) - Summary — リポジトリ数・要対応の数・Cleanup 候補・dsx 環境の状態を一覧し、クリックで該当のビューへ移動。dsx v0.13.0 以上では、直近の更新(Daily Refresh / sys update / Update All)の結果(失敗・スキップ・警告の件数)を「LAST RUN」に出す
- Cleanup Wizard — 全登録リポジトリの local branch 削除と remote-tracking ref prune を、実行直前の再検証付きで一括管理
- dsx Tools — dsx CLI の版の確認と self-update、
dsx sys update(確認つき)・-n(ドライラン)・repo update・doctorの実行。出力は実行ログコンソールに流れる。dsx v0.13.0 以上では、実行後に、失敗・スキップ・警告の内訳(どのマネージャ・リポジトリが、なぜ)を「LAST RUN」に出す - Settings — workspace root と手動登録リポジトリの管理
PowerShell で、次を実行する(自己署名の証明書 arbor.cer を信頼登録して、MSIX 版をインストールする。証明書のインポートのときだけ、UAC が出る)。
iex ([Text.Encoding]::UTF8.GetString((iwr -UseBasicParsing https://github.com/scottlz0310/arbor/releases/latest/download/install.ps1).Content).TrimStart([char]0xFEFF))- 更新は、Windows が、バックグラウンドで自動で行う(約 8 時間ごと)。Arbor のアプリ内の更新機能は、Windows 版には無い。
- 対応は、Windows 10(19041 以降)/ 11 の x64 のみ。WebView2 ランタイムが要る(Windows 11 は標準で入っている)。
- v0.3.0 までの msi / setup.exe 版: 先に、「設定 > アプリ」からアンインストールする。設定(
config.toml)は、~/.config/arbor/config.tomlに、初回の起動で引き継がれる(旧版の%APPDATA%\arbor\config.tomlは、コピーするだけで、消さない)。旧版が作った%LOCALAPPDATA%\dev.scottlz0310.arbor(WebView2 のデータ)は、MSIX 版では使わず、MSIX 版のアンインストールでも消えない。不要なら、手で削除する。 - 起動: スタートメニュー、または、シェルから
arbor。Daily Refresh は Bitwarden を使わないので、どちらで起動しても同じに動く。 - アンインストール: 「設定 > アプリ」。設定(
~/.config/arbor)は残る。信頼登録した証明書は、残る(不要なら、Cert:\LocalMachine\TrustedPeopleから削除する)。
Releases の、dmg(macOS)、AppImage・deb(Linux)。macOS は、署名・公証をしていない。
アプリ内の更新: 起動時に新しい版を確認し、あれば Toast で知らせる(適用はしない)。Tools タブの「ARBOR」で「更新を確認」→「ダウンロードして再起動」。
- Linux: AppImage だけが更新できる。deb は更新できないので、新しい deb を入れ直す(Tools タブにその旨を表示する)。AppImage は、実機(Ubuntu)で v0.6.0 から v0.7.0 への更新を確認済み。
- macOS: 実装は Linux と同じだが、未検証(実機がなく、署名・公証もしていないため、CI のビルドだけ)。更新できない場合は、dmg を入れ直す。
| ツール | バージョン | 用途 |
|---|---|---|
| Rust / rustup | rust-toolchain.toml の版 |
バックエンドビルド(rustup が自動導入) |
| Bun | .bun-version に準拠 |
パッケージ管理・フロントエンドツールチェーン実行 |
| cmake | 最新安定版 | git2 クレートのビルドに必要 |
| dsx CLI | 0.12.0+ | Daily Refresh(dsx run --root)に必要。dsx run が Bitwarden に触れない版(dsx#144) |
Windows: MSVC Build Tools または Visual Studio が必要
Bun の isolated linker はシンボリックリンクを使用します。
bun installが権限エラーになる場合は、Windows の 開発者モードを有効にしてください。macOS: Xcode Command Line Tools が必要
# 依存インストール(git フックも同時にセットアップされる)
bun install
# 開発サーバー起動(Vite + Tauri ホットリロード)
bun run tauri dev# リリースビルド(macOS: .app / .dmg、Linux: AppImage / deb。Windows は実行ファイルだけで、インストーラは作らない)
bun run tauri buildWindows の配布物(MSIX)は、tauri build では作らない。bun run tauri build --no-bundle で arbor.exe を作り、packaging/msix/Build-Msix.ps1 で MSIX にする(署名と手順は、CLAUDE.md の「リリース」)。
# フロントエンド
bun run typecheck # 型チェック
bun run test # bun test(ワンショット)
bun run test:watch # bun test ウォッチモード
bun run test:coverage # カバレッジ付きテスト
# Rust バックエンド(src-tauri/ 配下)
cargo check --manifest-path src-tauri/Cargo.toml
cargo clippy --manifest-path src-tauri/Cargo.toml
cargo test --manifest-path src-tauri/Cargo.toml- Bitwarden: Daily Refresh(
dsx run)は、Bitwarden のアンロックも環境変数の読み込みもしない(dsx v0.12.0 から)。未解錠でも動く。シークレットが要る用途(Mcp-Docker のコンテナの再作成など)は、ターミナルでdsx envを使う。Arbor は、Bitwarden の状態を表示も操作もしない。 - fetch の認証: Fetch / Fetch All は、git の認証情報ヘルパー(HTTPS。Windows は Git Credential Manager)と ssh-agent を使う。認証情報を入力する画面は無いので、先に
git fetchで認証を通しておく。 - Remote の確認: 「Remote を確認」は、GitHub CLI(
gh)を使う。gh auth loginで、ログインしておく(非公開リポジトリも、ghの認証で読む)。GitHub に問い合わせるため、自動では行わない。GitHub 以外の origin は、対象外。権限の無い非公開リポジトリは、GitHub が 404 で答えるため、「remote なし」と区別できない。 - 管理対象:
workspace.root直下の git リポジトリが、自動で一覧に入る。手動登録のうち、ディスク上に無いものは一覧・Fetch の対象から外れる(Settings の「無効なリポジトリを検出」から、登録を外せる)。
Frontend (React 19 + Zustand)
↕ Tauri IPC (invoke / events)
Rust backend (Tauri commands)
├── git2 — 状態取得・可視化・Cleanup の単一リポジトリ操作
├── dsx CLI — repo update など複数リポジトリの一括操作
└── reqwest — dsx の最新バージョン確認(GitHub Releases)
設定ファイルの保存先は、全 OS で ~/.config/arbor/config.toml(Windows は %USERPROFILE%\.config\arbor\config.toml)。
旧版の保存先(Windows の %APPDATA%\arbor\config.toml、macOS の ~/Library/Application Support/arbor/config.toml)に設定があり、新しい場所に無いときは、初回の起動でコピーする(旧ファイルは消さない)。
MIT © 2026 scottlz0310