📦
横断的にパッケージ管理できるツール「lazypkg」を作った

2025/03/23に公開
皆さんは各種パッケージマネージャーでインストールしたパッケージをどのように管理していますか？私は仕事ではMac、プライベートでの開発ではLinuxと環境が異なっているのもあり、ほとんどのツールや設定（dotfilesなど）をNix flake+Home Managerで管理しています。
しかし、どうしてもシュッと入れて試したいツールや特定のプロジェクトのみで利用するツール群についてはbrewやnpm install -g、aptのようなパッケージマネージャーで管理することも多いです。
複数のパッケージマネージャーを利用していると、網羅的にoutdatedなパッケージを把握することが難しくなりますし、各CLIのオプション引数も様々なので混乱しやすいです（例：updateかupgradeどっちだっけ・・・？）

 lazypkgというTUIアプリを作ったそこで、ターミナル上でいい感じにパッケージマネージャー横断でバージョン確認＆アップデートができるツール「lazypkg」を作りました。
https://github.com/ymtdzzz/lazypkg
利用方法のイメージについては後述しますが、以下の機能を提供します。
アップデート可能なパッケージの一覧表示
パッケージ名
現在のバージョン
新バージョン

パッケージ単体のアップデート
全パッケージのアップデート
なお、対応しているパッケージマネージャーは以下の通りです（2025/3/22時点）。ただし、こちらも後述しますが拡張可能な設計にしているため、自分が使っていて必要になったり需要がありそうなら追加予定です。
apt
gem
homebrew
npm
docker
!dockerについてはdocker hubのAPI制限回避のためデフォルトOFFになっています

 使い方
 インストール今の所Homebrewとgo install経由でのインストール方法を用意しています。
# Homebrew
brew install ymtdzzz/tap/lazypkg

# go install
go install github.com/ymtdzzz/lazypkg@latest
lazypkg -vが叩ければOKです。
lazypkg -v
# -> lazypkg version 0.0.7

 起動＆アップデート可能なパッケージの確認lazypkgで起動すると、自動的に対応しているパッケージマネージャーを検知して、サイドバーにリストアップ＆アップデート確認が行われます。
このとき、aptのようにrootで実行が必要な場合はパスワード入力用のダイアログが表示されますので入力してEnterで続行します。
※執筆前に全アプデしてしまったので以降はサンプルデータでのデモ画像です。
起動時点ではサイドバーにフォーカスがあたっています。
この状態では主に以下の操作が可能です。

↑↓orjk：パッケージマネージャーのフォーカスを移動

Enteror→orl：右ペインのパッケージ一覧にフォーカスを移動

Space：一括操作対象に今フォーカスされているパッケージマネージャーを加える

r：今フォーカスされているパッケージマネージャーのアップデートを再確認する

u：
（一括操作対象が無い場合）今フォーカスされているパッケージマネージャーの全パッケージをアップデートする
（一括操作対象が存在する場合）一括操作対象のパッケージマネージャーの全パッケージをアップデートする

なお、フォーカスの移動や複数選択、アップデート等の操作は右ペインのパッケージ一覧でもほぼ同じです。
色々ありますのでユースケース別に見ていきましょう。

 特定のパッケージをアップデートするhomebrewで管理しているterraformだけアップデートしたいとします。
サイドバーでhomebrewにフォーカスを合わせ、Enter or → or lで右ペインのパッケージ一覧に遷移します。
その後、terraformにフォーカスを合わせ、uを押下すると確認ダイアログが出てきます。
Enterを押すことでパッケージアップデートが実行されます。実行ログは下段にリアルタイムで出力されます（ctrl+j、ctrl+kでスクロール可）。
!demoモードなので適当なログを出していますが、実際はbrew upgrade terraformが実行されると思います
実行後はアップデートの再確認が行われ、アップデート済みのterraformはリストから排除されます。

 パッケージを複数選択してアップデートする同じくパッケージ一覧でSpaceを押下すると、今フォーカスされているパッケージの横に*が付きます。ffmpeg、terraform、wgetを選択してみます。
この状態でuを押すと、確認ダイアログの後3つのパッケージが一括でアップデートされます。

 特定のパッケージマネージャー配下のパッケージをすべてアップデートする例えばapt配下のパッケージをすべてアップデートしたい場合を考えます。パッケージ一覧にフォーカスしている場合は、Backspace or ← or hでサイドバーに戻ります。
サイドバーでaptにフォーカスしている状態でuキーを押すと、確認ダイアログをはさんでapt配下のパッケージをすべて更新できます。
上記の他、パッケージ一覧でaキーを押下しても同じ結果が得られます。
以上がlazypkgの基本的な使い方です。以降はモチベーション的な話と実装についてのお話になります。

 類似ツールがあるのになぜ作ったかこの手のツールとして有名なツールがすでにあります。それがtopgradeです。
https://github.com/topgrade-rs/topgrade
topgradeは対応しているパッケージマネージャーもとても多く優れたツールです。実際私もしばらく利用していました。
しかし、topgradeは「どのツールをどのバージョンにアップデートするか（できるか）」という情報を事前に提供してくれません。「とりあえずtopgradeコマンドを叩いておけば最新化できる」というのはわかりやすくてそれはそれで良いと思いますが、私としては少し違った思想を持ったツールを作りたくなりました。
グローバルにインストールされたパッケージは、それぞれ管理方法（やオプション引数などのインターフェース仕様）の違いはあるものの、やりたいことは結局のところ
インストールされているパッケージを確認したい
アップデート可能なパッケージを確認したい
アップデートしたいパッケージをアップデートしたい
これくらいかなと思います。これらの目的を満たすことさえできればパッケージマネージャーが何であるかはどうでもよく、それらの管理方法の差異をlazypkgが吸収できればユーザー（自分）が快適にパッケージ管理を行えると考えました。
!このうち、「インストールされているパッケージを確認したい」は、アップデート可能なものが確認できれば良さそうだったのでlazypkgのスコープ外にしています

 実装についてかなりまだ荒削りですが、実装について特筆すべき意思決定をご紹介します。なお、言語は一番馴染みのあるGolangを選んでいます。

 TUIフレームワークとしてbubbleteaを採用lazypkg以外にもTUIツールは作っていて、今もメンテを続けているotel-tuiについてはtviewを利用しています。
https://github.com/rivo/tview
otel-tuiについてはトレースのスパンをターミナル上でマッピングしてフレームグラフを表示する独自エンジンを実装するのに丁度良かったのでtviewを選択しました。
しかし、今回はElmアーキテクチャで状態管理を行うフレームワークであるbubbleteaを選択しました。
https://github.com/charmbracelet/bubbletea
実を言うとそこまできちんとPoCをした訳ではなく（個人開発なので・・・）、lazypkgにおいてはパッケージのアップデート処理など非同期で行いたいケースも多くなりそうで、そうなるとイベント駆動の方がやりやすいかな？と思ったからです。
Elmでは状態（Model）の変更はイベント（メッセージ）経由でのみ行えます。例えばパッケージのアップデートについても「アップデートの開始」と「アップデートの完了」で2種類のメッセージを定義しています。
// https://github.com/ymtdzzz/lazypkg/blob/85b8a4e01fb5c5a75797f530e8893e871759104b/components/messages.go#L27C1-L36C2
type updatePackagesStartMsg struct {
	name string
	pkgs []string
}

type updatePackagesFinishMsg struct {
	name string
	pkgs []string
	err  error
}
アップデート完了時には当該パッケージのローディングのスピナーを非表示（＝状態の更新）にし、アップデート確認を再度行いたい（＝新たなメッセージの送信）ので以下のようになります。
// https://github.com/ymtdzzz/lazypkg/blob/85b8a4e01fb5c5a75797f530e8893e871759104b/components/packages.go#L149-L157
	case updatePackagesFinishMsg:
		if msg.name == m.name {
			for _, pkg := range msg.pkgs {
				if i, ok := m.pkgToIdx[pkg]; ok {
					m.loading[i] = false
				}
			}
			cmds = append(cmds, m.getPackagesCmd())
		}
tviewではこうした状態管理のフローは自前で設計する必要がありカオスになりがちな印象ですが、bubbleteaでは仕組みが用意されているので道を踏み外しにくいです。
ただし、大規模なアプリになると扱うメッセージも増え、今の実装のようにメッセージが一つのファイルにずらずら書かれて各コンポーネントから参照する設計では無理が出てくると思います。

 拡張可能な設計今は限られたパッケージマネージャーしか対応していないですが、今後増やしやすいような設計にすることは意識しています。
各パッケージマネージャーのCLIとやりとりを行うモジュールはexecutorと名付けており、以下のinterfaceを満たすことができればいくらでも追加が可能な作りになっています。
// https://github.com/ymtdzzz/lazypkg/blob/85b8a4e01fb5c5a75797f530e8893e871759104b/executors/executor.go#L18-L39
// Executor defines the interface for package management operations
type Executor interface {
	// GetPackages retrieves a list of available package updates.
	// The password parameter is required for package managers that need elevated privileges.
	GetPackages(password string) ([]*PackageInfo, error)

	// Update performs an update operation on a single package.
	// If dryRun is true, it will only simulate the update without making actual changes.
	// The password parameter is required for package managers that need elevated privileges.
	Update(pkg, password string, dryRun bool) error

	// BulkUpdate performs update operations on multiple packages simultaneously.
	// If dryRun is true, it will only simulate the updates without making actual changes.
	// The password parameter is required for package managers that need elevated privileges.
	BulkUpdate(pkgs []string, password string, dryRun bool) error

	// Valid checks if the package manager is available and usable on the current system.
	Valid() bool

	// Close performs any necessary cleanup operations when the executor is no longer needed.
	Close()
}
各実装を見るとわかりますが、HomebrewであればGetPackages()ではbrew outdated --verboseの標準出力を正規表現でパースしたり、結構泥臭いことをやっています。
また、引数として設定しているpasswordですが、パスワード入力ダイアログ経由で渡せるようにひと工夫しています。
パスワード空文字で実行して失敗させる
エラー出力を検知して、エラーを詰めたメッセージをコンポーネントに渡してパスワードダイアログを表示
入力後のcallbackとして上記のコマンドを登録しておく

パスワード入力後、登録済みのcallbackにパスワードを渡して実行
!パスワードはできるだけメモリに残さないようstructに載せたりせず、特定の関数のスコープ外には持ち出さないようにしています

 さいごにlazypkgはシンプルなツールですが私自身毎日便利に使えています。追加したい機能（UIの改善や対応パッケージマネージャー追加など）はたくさんありますが、現状でもそこそこ使えるのでぼちぼちメンテしていくつもりです。
もし同じようなパッケージ管理の悩みどころを抱えている方がいて、lazypkgが少しでもその解消の手助けになりましたら幸いです。フィードバックもお待ちしております！
Discussion

ログインするとコメントできます