Maccy × ターミナル:macOSパワーユーザー向け環境構築ガイド

Maccy × ターミナル:macOSパワーユーザー向け環境構築ガイド

結論: Maccyがターミナルと相性が良いのは、pbcopyやpbpasteと同じシステムのペーストボードを監視しているからです。pbcopyにパイプで渡した内容、tmuxやNeovimからコピーした内容(システムクリップボードと連携させた場合)、ターミナル上で選択した内容は、すべてMaccy Appの履歴に残ります。あとは任意のアプリから検索・ピン留め・再ペーストができます。

この環境構築で何が解決できる?

20分前に長いkubectlコマンドを実行し、出力からPod名をコピーしました。その後、Slackのメッセージ、さらにURLをコピーしています。気づけばPod名はクリップボードから消えていて、シェル履歴にも残っていません。入力したコマンドからではなく、出力結果からコピーしたものだからです。

シェル履歴が記録するのは「打ち込んだもの」で、クリップボードマネージャが記録するのは「移動させたもの」です。ターミナル作業では後者がとにかく多くなります。ハッシュ、パス、IPアドレス、トークン、ログの断片、JSONの一部などです。Maccy Macはこの隙間を埋めてくれます。しかも常駐デーモンもアカウントもクラウド同期も不要で、ローカルで動くオープンソースのメニューバーアプリです。

レイヤー1:インストールと押さえておきたい設定

インストールはHomebrew、公式サイトからのダウンロード、Mac App Storeのいずれかで行えます。

brew install --cask maccy

設定画面はメニューバーのアイコンから開けます(ポップアップ表示中に⌘,でも開けます)。ターミナルで使うなら、触っておきたいのは次の項目です。

設定項目 おすすめ ターミナル作業で効く理由
検索モード(一般) MixedまたはRegexp コピーしたIPアドレスやハッシュを、文字列の完全一致ではなくパターンで探せます。
自動ペースト(一般) オン(アクセシビリティの許可ダイアログを受け入れられる場合) 項目を選ぶと、クリップボードに載せるだけでなく、フォーカス中のターミナルへそのまま貼り付けられます。
履歴の保存件数(ストレージ) スニペットを大量にコピーするなら、デフォルトより増やす ログの断片やハッシュはあっという間に流れていきます。
ピン(外観/ピン) 毎日打ち直す文字列を3〜5個ピン留めする ピン留めした項目は先頭に残り、履歴が溢れても消えません。
無視(Ignoreタブ) パスワードマネージャを追加し、ペーストボードタイプと正規表現も見直す シークレットを履歴に残さないための設定です。レイヤー5を参照してください。

「自動ペースト」を使うには、システム設定 → プライバシーとセキュリティ → アクセシビリティで許可が必要です。Maccy Clipboardがペーストのキー入力を合成して送るためです。macOSのアップデート後に突然ペーストされなくなったら、まずこのスイッチを確認してください。

レイヤー2:pbcopy / pbpaste のパイプライン

pbcopyは標準入力をシステムのペーストボードに書き込み、pbpasteはペーストボードの内容を標準出力に書き出します。Maccyは同じペーストボードを見ているので、pbcopyを呼ぶたびに履歴へ1件追加されます。

# 公開SSH鍵をGitHubに貼れる状態にする
pbcopy < ~/.ssh/id_ed25519.pub


# ログの末尾50行からエラーだけ抽出
tail -n 50 app.log | grep -i error | pbcopy

# コピーしたJSONを整形して、結果をクリップボードに戻す
pbpaste | jq . | pbcopy

# 現在のgitブランチ名(末尾の改行なし)
git branch --show-current | tr -d '\n' | pbcopy

# クリップボード上のリストをソートして重複を除去
pbpaste | sort -u | pbcopy

pbpaste | コマンド | pbcopyというパターンが基本の型です。ブラウザでコピーしたものをシェルで加工すると、整形後の結果がMaccyの先頭に入ります。元の内容も、キー操作ひとつで呼び出せます。

日常使いで気づいた点: Maccyはプッシュ通知を受け取るのではなく、一定間隔でペーストボードをポーリングしています。そのため、スクリプトが1秒に満たない間隔でpbcopyを何度も呼ぶと、途中の値が取りこぼされ、最後の値だけが記録されることがあります。対話的な使い方なら問題ありません。ループで大量の値を生成して、すべてを記録したい場合は、呼び出しの間に短いsleepを入れてください。

レイヤー3:tmux、Neovim、SSH

ターミナル上の選択範囲はMaccyに入る?

ターミナルによって異なります。Terminal.appでは、選択範囲に対して⌘Cを押せばシステムのペーストボードに書き込まれるので、Maccyにも記録されます。iTerm2では、選択しただけでコピーしたい場合にSettings → General → Selection → Copy to pasteboard on selectionを有効にします。この場合、選択するたびに履歴へ1件追加されるため、かなり騒がしくなります。本当に必要かどうかは、よく考えて決めてください。

tmux

コピーモードでのヤンクは、外へパイプしない限りtmux内部のバッファに留まります。~/.tmux.confに次の設定を追加しましょう。

set -g mode-keys vi
bind -T copy-mode-vi v send -X begin-selection
bind -T copy-mode-vi y send -X copy-pipe-and-cancel "pbcopy"

これでコピーモードでyを押すと、選択範囲がpbcopyへ渡され、結果としてMaccyにも入ります。ローカルのセッションならこれで動きます。一方、リモートマシンへのSSHセッション内ではpbcopyが存在しません。そこで登場するのがOSC 52です。

NeovimとVim

" init.vim / .vimrc
set clipboard=unnamedplus  " Neovim。macOSのVimでは必要に応じて =unnamed を使う

この設定をすると、ヤンク(y)がシステムのペーストボードに入り、Maccyに記録されます。ヤンクをVim内に閉じておきたいなら、設定は入れず、受け渡したいときだけ"+yを使ってください。

リモートサーバーからコピーする

OSC 52エスケープシーケンスに対応したターミナルなら、リモート側のプログラムからローカルのクリップボードに書き込めます。つまり、Maccyにも記録されます。iTerm2は対応していますが、設定で許可する必要があります(Settings → General → Selection → Applications in terminal may access clipboard)。tmuxではset -g set-clipboard onで転送されます。対応状況はターミナルごとに異なり、Terminal.appがOSC 52を扱えるとは限りません。次のコマンドで確認できます。

printf '\033]52;c;%s\a' "$(printf 'hello from remote' | base64)"

「hello from remote」がMaccyの先頭に現れれば、経路は正しくつながっています。

レイヤー4:シェルへ安全にペーストする

クリップボードマネージャを使うとペーストがあまりに簡単になり、何を貼っているのかを忘れがちです。身につけておきたい習慣は2つあります。

  • ブラケットペーストを前提にする。 最近のzshやbash(readline 8.1以降)ではブラケットペーストが有効で、複数行をペーストしても1行ずつ実行されず、プロンプト上で内容を確認できます。もしペーストした瞬間に実行されてしまうなら、お使いのシェルかターミナルがこの機能を使っていません。Webから拾ったコマンドを貼る前に必ず確認してください。
  • プレーンテキストでペーストする。 Maccyは書式なしでのペーストにも対応しており、ターミナルではほぼ常にこれが望ましい選択です。シェル自体はリッチテキストの影響を受けませんが、その中で動くエディタでは予期しない挙動を避けられます。お使いのバージョンについて、設定の「一般」にあるスイッチと修飾キーの挙動を確認してください。

Webページ上のコマンドは、画面に見えている内容と実際の中身が違うことがあります(隠し文字や差し替えられたテキストなど)。Maccyのプレビューで一呼吸置くか、Returnを押さずにプロンプトへ貼り付けて、内容を読んでから実行しましょう。

レイヤー5:シークレットと「記録させないもの」

多くのクリップボードマネージャの解説が触れない部分です。APIトークンをコピーすると、何もしなければMaccyはそれを記憶します。守ってくれる仕組みは次のとおりです。

仕組み できること 限界
ペーストボードタイプによるフィルタ コピー元アプリがconcealed(秘匿)やtransient(一時的)とマークした項目を、nspasteboard.orgの慣例に従ってスキップします。きちんと作られたパスワードマネージャはこのフラグを設定します。 コピー元アプリがフラグを立てる場合にしか機能しません。pbcopyは立てません。
アプリケーションの無視 指定したアプリからのコピーをすべてスキップします。 アプリ単位の制御なので、同じターミナル内でトークンと無害な文字列を区別できません。
正規表現による無視 定義したパターンに一致するコピー内容をスキップします。たとえば「途切れのない長いトークン」のような大まかな形です。 ヒューリスティックなので、一部のシークレットは見逃し、無害な文字列を誤って除外することもあります。
項目の削除 使用後すぐに履歴から項目を消します。 手動です。習慣づける必要があります。

正直にまとめると、pbcopyを通したものは普通のペーストボード書き込みなので、Maccyは通常のテキストとして扱います。シークレットは(フラグを立ててくれる)パスワードマネージャから取り出し、意図せず残った履歴は削除してください。無視リストに^[A-Za-z0-9+/=_-]{32,}$のような正規表現を入れておくと、トークンらしき文字列への安全網にはなりますが、保証ではありません。

Maccyが保存するデータはすべてMac内にとどまり、同期サービスは介在しません。これは確かなプライバシー上の利点ですが、同時に、履歴のプライバシーはディスクとログインセッションの安全性次第だということでもあります。

Maccyを開き(デフォルトのショートカットは⇧⌘C)、そのまま入力を始めます。検索モードをRegexpまたはMixedにしておけば、パターン検索が使えます。

探したいもの 入力するパターン
IPv4アドレス \b\d{1,3}(\.\d{1,3}){3}\b
40文字のgit SHA \b[0-9a-f]{40}\b
kubectlコマンド全般 ^kubectl
UUID [0-9a-f]{8}-[0-9a-f]{4}-
ホーム配下のファイルパス ^/Users/

毎日のように打ち直している文字列はピン留めしておきましょう。ステージング環境のホスト名、Dockerのログイン行、長いrsyncのオプション群などです。ピンは、新しいコピーに押し出されて古い項目が消えていく中でも残り続けます。

この構成はどこまで通用する?

  • シェル履歴の代わりにはならない。 Maccyが保存するのは、クリップボードに載ったものだけです。入力したコマンドにはatuin、Ctrl-Rと組み合わせたfzf、あるいは素のhistoryを使ってください。両者は補完関係にあります。
  • 同期はない。 ローカルファーストなので、リモートサーバーや別のMacとは履歴を共有しません。
  • ポーリング方式。 スクリプトによるごく高速なコピーは、1件にまとめられることがあります(レイヤー2を参照)。
  • 選択即コピーによるノイズ。 選択しただけでコピーされるターミナルでは、履歴がすぐに埋まります。オフにすることを検討してください。

まとめ:最小構成のパワーユーザー環境

最小構成は意外と小さく収まります。Maccyを入れ、検索をMixedまたはRegexpに切り替え、自動ペーストを許可し、tmuxとNeovimをpbcopyにつなぎ、シークレット用の無視ルールを設定する。それだけです。そのうえで最も効果が大きいのは、打ち直す代わりにpbpaste | … | pbcopyを使う習慣です。

試してみるなら、自分のワークフローに照らしてこう考えてみてください。いちばん頻繁に打ち直している文字列はどの3つか、そしてそれは明日までにピン留めすべきではないか。まずは試してみたい方へ、Maccyは無料のオープンソースソフトウェアです。


SEOパッケージ

1. タイトル案

  1. Maccy × ターミナル:macOSパワーユーザー向け環境構築ガイド
  2. ターミナルでクリップボード履歴を活用:Maccy設定ガイド
  3. pbcopy・tmux・Neovim・Maccyで作る快適クリップボード環境

2. メタディスクリプション

Maccyをターミナル、iTerm2、tmux、Neovimと連携。pbcopy/pbpasteパイプライン、安全なペースト、シークレット対策、正規表現検索まで解説するmacOS実践ガイド。

3. URLスラッグ

/ja/blog/maccy-terminal-power-user-setup/

4. キーワード

メインキーワード: Maccy ターミナル 設定

サブ/関連キーワード: 開発者向けクリップボードマネージャ Mac, pbcopy pbpaste, tmux システムクリップボード macOS, iTerm2 クリップボード履歴, Neovim クリップボード macOS, ターミナル クリップボード履歴 Mac, OSC 52 クリップボード, ブラケットペースト, クリップボードマネージャ 正規表現検索, クリップボード履歴 パスワード 残さない