Clippy

🚀 クリッピー 📎

ターミナルからファイルをコピーし、GUIアプリに貼り付けることができます。Finderに切り替える必要はもうありません。

macOS専用 - Macのクリップボードシステムに特化して開発されています。

🚀 クイックスタート

クリッピーは、ターミナルからファイルをコピーし、GUIアプリに貼り付けることができるツールです。Macのクリップボードシステムに特化しており、pbcopyではできないファイル参照のコピーを可能にします。

✨ 主な機能

1. なぜクリッピーなのか？

pbcopy はファイルの 内容 をコピーしますが、GUIアプリはファイルの 参照 を必要とします。pbcopy < image.png を実行しても、Slackやメールに貼り付けることはできません。これらのアプリは生バイトではなく、ファイルを期待しているからです。

クリッピーは、あなたが何をしたいかを検出し、適切なクリップボード形式を使用することで、このギャップを埋めます。

# ファイルを参照としてコピーする（任意のGUIアプリに貼り付ける）
clippy report.pdf         # Slack/メールに ⌘V でファイルをアップロード
clippy *.jpg             # 一度に複数のファイルをコピー

# データをファイルとしてパイプする
curl -sL https://picsum.photos/300 | clippy  # ダウンロード → ファイルとしてクリップボードに保存

# 直近のダウンロードファイルをコピーする（即座に）
clippy -r                # 直近にダウンロードしたファイルを取得
clippy -r 3              # 直近の3つのダウンロードファイルをコピー

# 直近のファイルを対話的に選択する
clippy -i               # 直近のダウンロードファイルのリストから選択
clippy -i 5m            # 直近5分間のファイルのみを表示する選択画面を表示

ターミナルにとどまり、あらゆるものをコピーし、どこにでも貼り付けましょう。

ターミナルファーストのクリップボードツールセット：クリッピー はファイルをクリップボードにコピーし、ペイスティ はそれらを賢く貼り付け、ドラッギー（オプションのGUI）はドラッグアンドドロップのワークフローをサポートします。カスタム統合のために Goライブラリ としても使用できます。すべてターミナルからのコンテキスト切り替えを最小限に抑えるように設計されています。

💡 特典：クリッピーには、ClaudeなどのAIアシスタントが生成した内容を直接クリップボードにコピーするための MCPサーバー が含まれています。

📦 インストール

Homebrew（推奨）

brew install neilberkman/clippy/clippy

ソースからビルド

# クローンしてビルド
git clone https://github.com/neilberkman/clippy.git
cd clippy
go build -o clippy ./cmd/clippy
sudo mv clippy /usr/local/bin/

# または go install を使用する
go install github.com/neilberkman/clippy/cmd/clippy@latest

💻 使用例

基本的な使用法

# ファイルを参照としてコピーする（任意のGUIアプリに貼り付ける）
clippy report.pdf         # Slack/メールに ⌘V でファイルをアップロード
clippy *.jpg             # 一度に複数のファイルをコピー

# データをファイルとしてパイプする
curl -sL https://picsum.photos/300 | clippy  # ダウンロード → ファイルとしてクリップボードに保存

# 直近のダウンロードファイルをコピーする（即座に）
clippy -r                # 直近にダウンロードしたファイルを取得
clippy -r 3              # 直近の3つのダウンロードファイルをコピー

# 直近のファイルを対話的に選択する
clippy -i               # 直近のダウンロードファイルのリストから選択
clippy -i 5m            # 直近5分間のファイルのみを表示する選択画面を表示

高度な使用法

# クリップボードをクリアする
clippy --clear         # クリップボードを空にする
echo -n | clippy       # これもクリップボードをクリアします

# ヘルプフラグの使用
clippy -v file.txt     # 実行結果を表示
clippy --debug file.txt # デバッグ用の技術的な詳細を表示

なぜ「クリッピー」なのか？

なぜなら、これはあなたが何をしたいかを知っている便利なクリップボードアシスタントだからです！ 📎

ペイスティ - インテリジェントなクリップボード貼り付け

Finderでファイルをコピーし、ターミナルで ⌘V を押すと、テキストとしてファイル名しか取得できません。ペイスティは実際にファイル自体を現在のディレクトリにコピーします。

主な使用例

1. Finderでファイルをコピー → ターミナルで実際のファイルを貼り付ける

# 1. Finderで任意のファイルをコピーする（⌘C）
# 2. ターミナルに切り替えて実行する：
pasty
# ファイルが現在のディレクトリにコピーされます（ファイル名だけではありません！）

2. 賢いテキストファイルの取り扱い

# Finderでテキストファイルをコピーする（⌘C）、次に：
pasty                    # ファイルのテキスト内容を標準出力に出力する
pasty notes.txt          # ファイルのテキスト内容をnotes.txtに保存する

インストールと使用方法

# Homebrewを通じてインストールする
brew install neilberkman/clippy/clippy

# またはソースからビルドする
go install github.com/neilberkman/clippy/cmd/clippy@latest
go install github.com/neilberkman/clippy/cmd/pasty@latest

ドラッギー - ビジュアルクリップボードコンパニオン

ドラッギーは、メニューバーアプリで、クリップボードのワークフローにビジュアル機能を追加します。クリッピーがターミナルからのコピーを処理する一方で、ドラッギーはファイルをアプリケーションにドラッグするためのビジュアルインターフェイスと、直近のダウンロードファイルを表示する機能を提供します。

重要：ドラッギーは別のオプションのツールです。クリッピーと一緒に自動的にインストールされることはありません。

機能

主な機能

• ドラッグアンドドロップのブリッジ - クリップボードのファイルをウェブブラウザ、Slack、その他のアプリにドラッグできるようにします。
• 直近のダウンロードファイルビューア - クリック1回でクリップボードと直近のダウンロードファイルを切り替えることができます。
• ファイルサムネイル - 画像やPDFのビジュアルプレビューをファイルリスト内に表示します。
• クイックプレビュー - ホバー時に ⌥ オプションキーを押すと、より大きなプレビューを表示します。
• ゼロバックグラウンドアクティビティ - ポーリングやバッテリー消費がなく、必要なときにのみアクティブになります。

ユーザーエクスペリエンス

• ダブルクリックで開く - メニューから離れることなく、すばやくファイルにアクセスできます。
• キーボードショートカット - ESCで閉じる、スペースキーで更新することができます。

デザイン哲学

• クリップボードマネージャーではない - 履歴やデータベースがなく、複雑さを排除しています。
• ターミナルファーストのワークフロー - ターミナルの使用を補完するように設計されており、置き換えることを目的としていません。
• 最小限で完全 - すべての機能は特定のワークフローニーズに対応しています。

インストール

# 別途Homebrewでインストールする（クリッピーに含まれていません）
brew install --cask neilberkman/clippy/draggy

⚠️ 重要提示

初回起動時、macOSはドラッギーがコード署名されていないため、セキュリティ警告を表示する場合があります。「ドラッギーは損傷していて開けません」と表示された場合は、以下の対処法があります。

• Homebrewのキャスクはインストール中に自動的にクォランタインフラグを削除します。
• 警告が続く場合は、xattr -dr com.apple.quarantine /Applications/Draggy.appを実行してください。
• または、Draggy.appを右クリックして「開く」を選択し、ゲートキーパーをバイパスすることもできます。

使用方法

# ターミナルでファイルをコピーする：
clippy ~/Downloads/*.pdf    # クリッピーでPDFをコピーする
curl -sL image.jpg | clippy # ダウンロードをパイプしてクリップボードに保存する
clippy -r                   # 直近のダウンロードファイルをコピーする

# ドラッギーのGUIを使用する：
# 1. メニューバーのドラッギーアイコンをクリックする
# 2. ファイルをブラウザのアップロードフィールド、Slackなどにドラッグする
# 3. 時計アイコンで直近のダウンロードファイルビューに切り替える
# 4. ⌥ オプションキーを押しながらファイルをプレビューする
# 5. ダブルクリックでファイルを開く

ワークフロー例

GitHubにスクリーンショットをアップロードする

# スクリーンショットを撮る（macOSはデスクトップに保存する）
# ターミナルで：clippy ~/Desktop/Screenshot*.png
# ドラッギーで：GitHubのコメントボックスにドラッグする

迅速なファイル共有

# ターミナル：clippy ~/Downloads/report.pdf
# ドラッギー：サムネイルが表示され、Slackやメールにドラッグできる

直近のダウンロードファイルのワークフロー

# ブラウザでファイルをダウンロードする
# ドラッギーをクリック → 時計アイコンをクリック → ダウンロードファイルが表示される
# 必要な場所にドラッグするか、ダブルクリックで開く

哲学

ドラッギーは意図的にクリップボードマネージャーではありません。履歴や検索機能、データベースはありません。これはターミナルのクリップボードワークフローとGUIアプリケーションの間のビジュアルブリッジです。ターミナルユーザーが時々クリップボードに何があるかを確認したり、ファイルをどこかにドラッグしたりして、すぐに作業に戻れるようにするためのものです。

MCPサーバー

クリッピーには、AIアシスタントが生成した内容を直接クリップボードにコピーできる組み込みのMCP（モデルコンテキストプロトコル）サーバーが含まれています。

Claudeに任意のテキスト（コード、メール、ドキュメントなど）を生成させ、すぐにどこにでも貼り付けることができます。

• 「CSVファイルを処理するPythonスクリプトを作成し、クリップボードにコピーしてください」
• 「会議に関するメールを下書きし、クリップボードに保存してください」
• 「その正規表現を生成し、エディタに貼り付けられるようにクリップボードにコピーしてください」

チャットインターフェイスから手動で選択してコピーする必要はもうありません。

セットアップ

Claude Desktopの設定ファイル (~/Library/Application Support/Claude/claude_desktop_config.json) に以下を追加します。

{
  "mcpServers": {
    "clippy": {
      "command": "clippy",
      "args": ["mcp-server"]
    }
  }
}

利用可能なツール

• clipboard_copy - テキストまたはファイルをクリップボードにコピーする
• clipboard_paste - クリップボードの内容をファイルまたはディレクトリに貼り付ける
• get_recent_downloads - 直近にダウンロードしたファイルのリストを取得する

Claudeが内容を生成し、それを直接クリップボードに保存して、必要な場所にすぐに貼り付けることができます。

ライブラリ

クリッピー は、独自のアプリケーションでGoライブラリとして使用することができます。

go get github.com/neilberkman/clippy

高レベルAPI

import "github.com/neilberkman/clippy"

// 賢いコピー - 自動的にテキストとバイナリファイルを検出する
err := clippy.Copy("document.pdf")

// 複数のファイルを参照としてコピーする
err := clippy.CopyMultiple([]string{"image1.jpg", "image2.png"})

// テキスト内容をコピーする
err := clippy.CopyText("Hello, World!")

// リーダーからデータをコピーする（テキスト/バイナリ検出を処理する）
reader := strings.NewReader("Some content")
err := clippy.CopyData(reader)

// 標準入力からコピーする
err := clippy.CopyData(os.Stdin)

// クリップボードの内容を取得する
text, ok := clippy.GetText()
files := clippy.GetFiles()

機能

• 賢い検出：自動的にファイル参照またはテキスト内容としてコピーするかを判断します。
• 複数のファイル：一度に複数のファイルをコピーすることができます。
• リーダーサポート：自動的な形式検出を伴う任意のio.Readerからコピーできます。
• クリップボードアクセス：現在のクリップボードの内容（テキストまたはファイルパス）を読み取ります。
• クロスプラットフォームタイプ：標準のGoタイプを使用し、内部的にプラットフォーム固有のクリップボードを処理します。

📄 ライセンス

MIT