winget / CLIwinget / CLI

syncwingetlink

wingetの壊れたsymbolic linkを修復Repairs broken winget symbolic links

winget のポータブルパッケージで作られるべきシンボリックリンクの欠落・破損を検出し、再作成するネイティブ CLI ツールです。インストール済みのポータブルパッケージを列挙し、Links フォルダにあるべきリンクと突き合わせて、ユーザー確認のうえで再作成します。winget normally creates a command-alias symlink in the Links folder for portable packages. When it is missing or broken, syncwingetlink compares installed packages against the links that should exist and recreates them after confirmation.

syncwingetlink

主な機能Features

検出Detect

インストール済み portable パッケージを列挙し、リンク状態を Ok / Missing / Broken / Mismatch に分類します。Enumerates installed portable packages and classifies each link as Ok / Missing / Broken / Mismatch.

修復Repair

欠落・破損した symlink をユーザー確認のうえで作成します(--dry-run 対応)。Creates missing or broken symlinks after confirmation. Preview first with --dry-run.

エイリアス正規表現ルールAlias regex rules

codex-x86_64-pc-windows-msvc.exe → codex.exe のようなプラットフォーム接尾辞の除去ルールをカスタマイズできます。Customizable rules strip platform suffixes, e.g. codex-x86_64-pc-windows-msvc.exe → codex.exe.

CLI / TUICLI / TUI

通常は CLI、--tui で対話的なチェックリスト操作ができます。CLI by default; --tui opens an interactive checklist for batch creation.

winget COM API を優先winget COM API first

Microsoft.Management.Deployment から権威的に列挙し、利用不可時はファイルシステム走査へ自動フォールバックします。Enumerates via Microsoft.Management.Deployment, falling back to filesystem scanning automatically.

インストール手順Installation

  1. winget でインストールInstall with winget
    winget install kkamegawa.syncwingetlink
  2. 検出のみ(読み取り専用)Check link state (read-only)
    syncwingetlink scan
  3. 何が行われるかを確認してから修復Preview, then repair
    syncwingetlink fix --dry-run
    syncwingetlink fix

更新履歴Changelog

リリースごとの変更内容は GitHub Releases に掲載しています。Release notes for each version are on GitHub Releases. Releases ↗