🧩 最新の workmux を Debian にインストール

workmux とは

workmux はブランチ 1 本をワークスペース 1 つに変えます。workmux add ひとつで git worktree を作り、対応する tmux ウィンドウを開き、新しいチェックアウトに足りないファイル（.env や資格情報）をコピーし、入れ直したくないもの（node_modules）にシンボリックリンクを張り、セットアップコマンドを実行して、指定したペイン配置まで組み立てます。workmux merge はそれを一手で巻き戻します。ブランチをマージし、worktree を削除し、ウィンドウを閉じ、ローカルブランチを消す。stash も、ブランチの切り替えも、次の作業を塞ぐ中途半端なチェックアウトも要りません。

⚡ workmux の主な機能

📦 deb.griffo.io からインストールする

sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt update

install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt update

sudo apt install extrepo
sudo extrepo enable griffo
sudo apt update

# 最新の workmux をインストール
sudo apt install workmux

# tmux は既定のバックエンドですが「推奨」止まりです。
# kitty、WezTerm、Zellij でも動くからです
sudo apt install tmux

# インストールを確認
workmux --version

# 最新の workmux をインストール
apt install workmux

# tmux は既定のバックエンドですが「推奨」止まりです。
# kitty、WezTerm、Zellij でも動くからです
apt install tmux

# インストールを確認
workmux --version

# 任意: このプロジェクト用の .workmux.yaml を書く
cd ~/src/my-project
workmux init

# tmux の中から: ブランチ、worktree、ウィンドウ、ペインを 1 コマンドで
workmux add new-feature

# 作業が終わったら: マージしてまとめて片付け
workmux merge

# bash、zsh、fish の補完はパッケージに同梱
workmux --help

🎯 基本的な使用例

日々の流れ:

# ブランチ、worktree、tmux ウィンドウを作る
workmux add fix-login

# 既存のブランチは名前で拾われます
workmux add existing-work

# 既定とは違うベースから枝分かれする
workmux add hotfix --base production

# プルリクエストを専用の worktree に取り出す
workmux add --pr 123

# 進行中のものを一覧する
workmux list

# マージしてすべて撤収
workmux merge

# あるいはマージせずに捨てる
workmux remove fix-login

ウィンドウ、ペイン、復旧:

# 切り替えずにウィンドウだけ作る
workmux add docs-pass --background

# worktree とブランチは残してウィンドウだけ閉じる
workmux close docs-pass

# あとでまた開く
workmux open docs-pass

# tmux やマシンが落ちたあと、全ウィンドウを作り直す
workmux resurrect

# どこからでも worktree に入る
cd "$(workmux path fix-login)"

エージェントを並行で走らせる:

# エージェント用のステータスフックとスキルを入れる
workmux setup

# エージェントへのプロンプト付きで worktree を始める
workmux add add-tests --prompt "パーサーのユニットテストを追加して"

# すべてのエージェントを 1 つの TUI で見る
workmux dashboard

# または tmux にライブのステータスサイドバーを出す
workmux sidebar

# 動いているエージェントに指示を送る
workmux send add-tests "エラー経路もカバーして"

# そのエージェントが終わるまで待つ
workmux wait add-tests

🚀 deb.griffo.io を選ぶ理由

• ✅ apt で入る唯一の場所: workmux は Debian にも Ubuntu にも収録されていません。このリポジトリが上流公式のビルドをパッケージ化しています
• ✅ エージェント対応は毎週動く: workmux が追跡・操作できるエージェントはリリースごとに変わります。最新かどうかが、機能が使えるか存在しないかの分かれ目です
• ✅ 自動更新: 上流のリリースから数時間以内にパッケージを更新
• ✅ 完全なパッケージ: 上流のバイナリを /usr/bin/workmux に、加えて bash、zsh、fish の補完
• ✅ 正直な依存関係: パッケージは git に依存し、tmux は推奨にとどめています。kitty、WezTerm、Zellij も対応バックエンドだからです
• ✅ 2 つのアーキテクチャ: amd64 と arm64。どちらも静的リンクなので、同じパッケージがどのスイートでも動きます
• ✅ マルチディストリビューション: Bookworm、Trixie、Forky、Sid で動作
• ✅ 手間のかからない運用: 更新は通常の apt コマンドだけ

📦 パッケージのビルドリポジトリ

Debian パッケージは、この GitHub リポジトリで自動的にビルド・管理されています:

• 🧩 workmux-debian - 最新リリースのビルド

🔗 関連パッケージ

deb.griffo.io では、こちらも配布しています:

• lazygit - 各 worktree の中の git 作業を担うターミナル git UI
• GitUI - もう一つの高速なターミナル git クライアント。こちらの流儀が好みなら
• Zellij - マルチプレクサのバックエンドとして、tmux の対応済みの代替
• Serie - そのブランチが実際に何をしたのかを読み直すためのコミットグラフ