Using Copybuffer

Learn how to make the most of Copybuffer's clipboard management features.

Start Clipboard Monitoring

Start the clipboard monitor to automatically save clipboard history:

copybuffer start

This will run in the foreground. Press Ctrl+C to stop.

Basic Commands

📋

List Clipboard History

View your recent clipboard entries:

# Show last 10 entries (default)
copybuffer list

# Show last 20 entries
copybuffer list --limit 20
🔍

Search Clipboard History

Search for specific content:

copybuffer search "your search query"

# Limit results
copybuffer search "query" --limit 5
📤

Copy from History

Copy a previous clipboard entry back to your clipboard:

copybuffer copy <entry-id>
🗑️

Delete & Clear

Remove entries from history:

# Delete specific entry
copybuffer delete <entry-id>

# Clear all history
copybuffer clear --yes

Advanced Features

💾

Export/Import History

# Export
copybuffer export ~/backup.json
# Import
copybuffer import ~/backup.json
☁️

GitHub Gist Sync

# Sync to Gist
copybuffer sync-to-gist
# Sync from Gist
copybuffer sync-from-gist
⌨️

Hotkeys

Default hotkeys (configurable):

  • F9 - Toggle clipboard history
  • F10 - Search clipboard
⚙️

Configuration

# View config
copybuffer config
# Set value
copybuffer config-set maxHistorySize 2000

Example Workflow

# Start monitoring clipboard

copybuffer start

# (In another terminal) List your clipboard history

copybuffer list

# Search for something you copied earlier

copybuffer search "function"

# Copy a previous entry back to clipboard

copybuffer copy <entry-id>

Setting up GitHub Gist Sync

  1. Create a GitHub Personal Access Token:

    Go to GitHub Settings → Developer settings → Personal access tokens → Generate new token with gist scope

  2. Configure Copybuffer:

    # Enable gist sync
copybuffer config-set gist.enabled true

# Set your GitHub token
copybuffer config-set gist.token YOUR_GITHUB_TOKEN