@it-bens-ai/clipboard-agent-tools

Clipboard MCP tools for pi: copy inline text or a file's contents to the system clipboard, with a bash check that keeps the agent on the MCP tools.

Packages

Package details

extension

Install @it-bens-ai/clipboard-agent-tools from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@it-bens-ai/clipboard-agent-tools
Package
@it-bens-ai/clipboard-agent-tools
Version
2.0.1
Published
Oct 28, 2026
Downloads
466/mo · 466/wk
Author
spigandromeda
License
MIT
Types
extension
Size
198.6 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "image": "https://raw.githubusercontent.com/it-bens-ai/clipboard-agent-tools/main/.github/assets/social-preview.png",
  "extensions": [
    "./plugins/clipboard-copy/pi/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

Clipboard Agent Tools

Clipboard Agent Tools

bash 5.1+ jq 1.7+ CI License: MIT

Claude Code plugin Codex plugin Pi package

A marketplace repository for clipboard tools that AI coding agents call as MCP tools.

The clipboard-copy plugin runs a Bash MCP server exposing clipboard_copy (inline text) and clipboard_copy_file (contents of a file at an absolute path). It uses the platform clipboard utility and falls back to OSC 52 escape sequences over SSH and in headless environments. Hooks on Claude Code and Codex, and the extension on Pi, name the MCP tools at session start and block native clipboard-write Bash commands.

Components

Plugin MCP server Hooks
clipboard-copy clipboard_copy and clipboard_copy_file SessionStart directive and PreToolUse Bash block; Pi covers how Pi runs them

Requirements

  • bash 5.1+ and jq 1.7+, first on the PATH the agent host starts the MCP server with. The server exits at startup under an older bash or jq. macOS ships /bin/bash 3.2; install a newer one (for example brew install bash).
  • ps and mkfifo, used by the MCP core to supervise tool-call processes
  • base64 or openssl, used only by the OSC 52 fallback
  • A platform clipboard utility when you want to skip OSC 52; Backends lists them per platform
  • Pi only: Node.js 22.19+ and Pi 1.x. Pi support covers macOS and Linux; Pi lists the tested Pi versions.

Install

Claude Code

/plugin marketplace add it-bens-ai/clipboard-agent-tools
/plugin install clipboard-copy@clipboard-agent-tools

Restart Claude Code after installation so the MCP server is registered. Run /mcp in the new session and check that the clipboard-copy server and its two tools appear.

Codex

codex plugin marketplace add it-bens-ai/clipboard-agent-tools
codex plugin add clipboard-copy@clipboard-agent-tools

Start a new Codex task after installation.

Pi

pi install npm:@it-bens-ai/clipboard-agent-tools

To install from the Git repository instead:

pi install git:github.com/it-bens-ai/clipboard-agent-tools

Run pi list to check that the package is configured. On Pi the tools are deferred; see the plugin's Pi guide.

Documentation

plugins/clipboard-copy/README.md introduces the plugin and indexes its guides in plugins/clipboard-copy/docs/: tools, backends, hooks, Pi, troubleshooting, architecture, and testing. Development covers the repository layout, hosts, test commands, and CI, and Releasing covers version bumps and npm publishing.

License

MIT.