macker

macker

自分が所有する複数のマシン(据え置き Mac、MacBook、Mac mini など)で動く ターミナル/開発セッションを、Tailscale tailnet 越しに1つの CLI からまとめて 管理するツール。自分の tailnet・自分のマシンの中だけで動く、個人用の リモート開発セッション管理です。

macker は tmux + Tailscale の上に乗る薄いコントロールプレーンです。ターミナル 多重化やトランスポート暗号化は再実装しません(端末ストリームは ssh+tmux、 メンバーシップ・identity・暗号化は Tailscale に委譲)。その上に、セッションの 可視化、ワンコマンド attach、ノードでの認可付きコマンド実行、追記専用の 監査ログ、複数ノードを並べる グリッド を足しています。長時間動く開発作業 (ビルド、対話シェル、エージェント的なツールなど)を別マシンで走らせ、手元の 1ウィンドウから見渡すのが狙いです。

アーキテクチャと設計判断は DESIGN.md を参照。

なぜ tmux に attach するのか

これはセキュリティの回避策ではありません。自分のマシンに、自分が正規に ログインしている状態で、リモートからアクセスするための実務的な工夫です。

macOS の login Keychain は GUI でログインしたときにアンロックされます。一方、 素の ssh で入った非 GUI セッションはその Keychain にアクセスできないため、 GUI から起動して認証情報を Keychain に持つ種類のツール全般(Claude Code に限らず)が リモートからは正しく動かないことがあります。これは macOS 一般の挙動で、特定の ツールの認証を破るものではありません。

macker は、すでに自分の GUI ログインセッション内で動いている tmux サーバに attach します。そこは正規にアンロック済みの環境なので、ふだん画面の前で 作業しているのと同じ状態がそのまま使えます。これが、agent を(ログイン前の LaunchDaemon ではなく)LaunchAgent(GUI セッション内)で動かす理由でもあります。

インストール

公開リポジトリから直接:

go install github.com/masakasuno1/macker/cmd/macker@latest

$(go env GOPATH)/bin に macker が入ります。そこへ PATH を通してください (ソースからのビルド手順は下の「はじめかた」2 を参照)。

はじめかた

各マシンで一度だけ:

1. 各マシンに Tailscale を入れてサインインし、全マシンを同じ tailnet に参加させる。 macOS なら Tailscale.app を入れて GUI でログインするだけで OK(CLI 派なら tailscale up)。macker は tailscale CLI を Tailscale.app のバンドル内からも 自動検出するので、アプリだけ入っていれば別途 CLI を用意する必要はない (見つからない場合は MACKER_TAILSCALE_BIN でパス指定可)。

2. macker 実行ファイルを各マシンに用意し、PATH の通った場所に置く。方法は2つ:

   • 公開リポジトリから直接インストール(各マシンで楽):

     go install github.com/masakasuno1/macker/cmd/macker@latest
     # $(go env GOPATH)/bin に macker が入る。そこに PATH を通しておく:
     #   export PATH="$(go env GOPATH)/bin:$PATH"
     

   • ソースからビルド(このリポジトリをクローンして、ルートで):

     go build -o macker ./cmd/macker   # ルートに ./macker が1個できるだけ
     sudo mv macker /usr/local/bin/     # PATH の通った場所へ自分で移す
     

3. ノードデーモンを起動する。macOS では LaunchAgent として入れて、GUI ログイン セッション内で動かす(Keychain アクセスに必須。下記参照):

   cp example/ai.masao.macker.plist ~/Library/LaunchAgents/
   # plist 内の macker バイナリのパスを自分の環境に合わせて書き換えてから:
   launchctl load ~/Library/LaunchAgents/ai.masao.macker.plist
   

   とりあえず試すだけなら、ターミナルで macker agent を直接動かしてもよい。

4. (任意)ハブにする1台で macker collector も動かすと、どのノードで何が走った かの履歴を中央に集約できる。

あとは普段の操作(どのマシンからでも):

macker ls                       # 誰がオンラインで何が動いているか
macker mac-mini                 # そのマシンで新しいセッションを開く(ウィンドウ1つにつき1セッション)
macker mac-mini:dev             # 名前付きの再 attach 可能なセッションに入る(無ければ作成)
macker mac-mini dev             # 同じ。コロンの代わりにスペースで指定する形式
macker mac-mini 0               # `macker mac-mini ls` で 0 番目に出ているセッションへ attach
macker mac-mini ls              # そのマシンのセッションを詳細表示(clear/attach の判断用)
macker mac-mini:dev clear       # そのセッションをリセット(次の attach は新規)
macker exec macbook -- git pull # ノード上で認可付きコマンドを1つ実行
macker usage                    # 各ノードの AI アカウント(claude/codex)と残量を一覧
macker storage put shot.png     # ハブの共有ストレージへアップロード(全ノードから get できる)

macker <マシン名> がそのまま attach です(attach と打つ必要はありません)。 素の macker <node> はウィンドウごとに独立した新規セッションを開き、その窓を 閉じるとそのセッションだけが kill されます。続きをやり直したいセッションは <node>:<session> の名前付きにしておくと、detach・再 attach できます。

tab 補完(zsh) を入れておくと、サブコマンド・ライブなノード名・<node>: の 後のセッション名まで補完されます:

eval "$(macker completion zsh)"   # ~/.zshrc の `compinit` の後に追記

最初に話していたユースケース — 1ウィンドウに複数マシンのグリッド:

macker grid self mac-mini macbook mac-mini-2

4つのペインがタイル表示され、各ペインが別マシンのセッションに attach します (自分のマシンが左上、ほかが周りに)。ctrl+c を連打する(または窓を閉じる)と そのマシンのセッションが終了、ラップトップを sleep しても全部生き残るので後で 再 attach できます。

コマンド