What Is PasteLocal?
PasteLocal is one of the best SSH Utilities tools for developers. It is an open-source clipboard bridge built by Zen Open Source contributors with significant assistance from Grok Build (xAI), and it moves text, images, and screenshots from your local machine into a remote shell over an existing SSH connection. It is aimed at developers who work in the terminal, use Claude, Cursor, Windsurf, or similar agentic coding tools, and hate losing clipboard context when they jump onto a VPS or cloud instance.
PasteLocal matters because it turns clipboard access into a deterministic shell workflow instead of a manual copy-paste problem. The project ships a four-command quick start, a production-ready v1.0 relay, clipboard history, named snippets, and a TUI status screen, which gives it enough surface area to be useful in real remote development sessions.
Quick Overview
| Attribute | Details |
|---|---|
| Type | SSH Utilities |
| Best For | developers |
| Language/Stack | Go, SSH tunnels, TOML config, TUI |
| License | MIT |
| GitHub Stars | N/A as of Feb 2026 |
| Pricing | Open-Source |
| Last Release | v1.0 — date not listed on page |
Who Should Use PasteLocal?
- Remote-first developers who live over
sshand need a reliable way to bring local screenshots and copied text into a cloud VM, bastion host, or cheap VPS. - Agentic coding users running Claude, Cursor, Windsurf, or similar tools in a terminal session and wanting a clean
/pasteworkflow instead of manually uploading files. - Indie hackers debugging production issues from a laptop and needing clipboard history, named snippets, and fast access to ephemeral context like error screenshots.
- Platform engineers who need a lower-friction alternative to ad hoc
scp, browser uploads, or copy pipes when troubleshooting infrastructure from remote shells.
Not ideal for:
- Teams that never work over SSH and already have a shared desktop clipboard solution.
- Users who want a fully managed SaaS sync layer instead of an open-source local daemon.
- Environments where installing a local helper process is prohibited by policy.
Key Features of PasteLocal
- SSH-only clipboard transport — PasteLocal uses your existing encrypted SSH connection, so no extra public service or new inbound port is required. That design keeps the blast radius small and makes it easier to run on laptops, workstations, and locked-down networks.
- Image and screenshot support — PasteLocal handles text and images, including screenshots, which is the difference between copying a code sample and preserving the exact UI state you were looking at. For remote debugging, that matters more than plain text sync.
- Agentic coding tool commands — The
/paste,/paste-history,/paste-snippet, and/paste-sendflows are built for terminal agents, not for generic desktop sync. If you use Claude Code Canvas or Claude Context Mode, PasteLocal gives those sessions actual clipboard context instead of stale text retyping. - Clipboard history and index selection —
pastelocal-remote --listand--indexlet you revisit older entries rather than racing to paste the last thing you copied. That is useful when an agent asks for a previous screenshot, a pasted command, or a reference snippet from earlier in the session. - Named snippets — You can save recurring text or images with
pastelocal snippets save api-keyand recall them remotely by name. That turns repetitive setup text, command templates, and boilerplate into a reusable local asset. - TUI dashboard and health checks —
pastelocalexposes daemon status, host configuration, and recent activity in a terminal UI, whilepastelocal doctor --fixtries to diagnose and repair common issues automatically. That saves time when SSH forwarding, config, or daemon state drifts. - Multi-device relay mode — The v1.0 relay adds E2E-encrypted clipboard sharing without requiring pairwise SSH tunnels between every device. It is the right architecture for multi-device or cloud-heavy workflows, but the page still recommends SSH mode for day-to-day use.
PasteLocal vs Alternatives
| Tool | Best For | Key Differentiator | Pricing |
|---|---|---|---|
| PasteLocal | Remote clipboard sharing over SSH | Local daemon plus SSH tunnel keeps clipboard and screenshots available in remote shells | Open-Source |
| tmux + OSC52 | Simple terminal clipboard passthrough | Works inside terminal multiplexers, but is text-first and less opinionated about history and snippets | Free |
| scp / manual file upload | One-off file transfer | Good for moving a screenshot file, bad for preserving a fast paste workflow in an agent session | Free |
| Teleport | Enterprise remote access | Strong identity and access controls, but it is not built specifically for clipboard capture and remote paste | Paid / Enterprise |
Pick tmux + OSC52 if you only need basic text forwarding and already live inside a multiplexed terminal. Pick scp or manual upload if the real job is transferring a single file and you do not need clipboard semantics. Pick Teleport when your organization cares more about access policy and auditability than clipboard ergonomics.
PasteLocal is the better fit when the problem is not remote access itself but the missing bridge between your laptop clipboard and an agent working in a remote shell. That makes it a strong companion to terminal-native workflows, especially if your agent is running inside OpenSwarm or another orchestration layer that still needs human-provided screenshots and snippets.
How PasteLocal Works
PasteLocal uses a local daemon, pastelocald, to watch and store clipboard state, then exposes that state to a remote machine over an SSH tunnel. The remote side runs pastelocal-remote, which asks the local daemon for the latest text, image, history item, or named snippet and writes it to a file path the remote tool can read.
The architecture is intentionally boring, and that is the point. The config lives in ~/.config/pastelocal/config.toml, history is bounded by size and TTL, and the relay mode adds per-peer encryption for multi-device sync without changing the day-to-day SSH workflow.
# local machine
make build
./bin/pastelocal init
./bin/pastelocal add-host myserver
# remote machine over SSH
pastelocal-remote --list
pastelocal-remote
That flow gives the remote session a file path that points to the clipboard payload, so the agent can read the file directly and then clean it up with rm <path>. In practice, this means your remote AI assistant can inspect screenshots, pasted code, or cached snippets without any browser hop, file upload dialog, or ad hoc copy mechanism.
Pros and Cons of PasteLocal
Pros:
- No new exposed port — traffic rides over the SSH session you already trust.
- Screenshots work — image clipboard support is first-class, which is rare for terminal-native clipboard tools.
- History and snippets are built in — you are not limited to the last copied item.
- Good fit for agents — the remote
pastelocal-remotecommand is easy to script into Claude-style workflows. - TUI plus
doctorreduce setup friction — you can inspect state and repair common failures from the terminal. - MIT licensed — easy to audit, fork, and extend.
Cons:
- Requires a local daemon — PasteLocal is not zero-process; you need
pastelocaldrunning on the source machine. go installis not reliable yet — the page explicitly warns about a pending module path update, so release binaries or source builds are safer.- Relay mode is still the exception — SSH remains the recommended workflow, so multi-device sync is not the default path.
- Best experience is terminal-centric — if your workflow lives entirely in a GUI clipboard manager, PasteLocal adds extra concepts.
- File cleanup is manual — remote clipboard payloads are saved to disk and should be removed after use.
Getting Started with PasteLocal
PasteLocal starts with either a release binary or a local build, and the build-from-source path is the safest option right now. If you want the shortest path from clone to remote paste, use the following commands on your local machine and then run the remote helper over SSH.
git clone https://github.com/Zen-Open-Source/PasteLocal.git
cd PasteLocal
make build
./bin/pastelocal init
./bin/pastelocal add-host myserver
ssh myserver 'pastelocal-remote'
After those commands, pastelocal-remote returns a file path on the remote machine that points to the current clipboard payload. If you copied a screenshot, that path will usually end in an image extension, and your agent or shell can read it directly before you delete it.
If the install misbehaves, ./bin/pastelocal doctor --fix is the first command to run. The config file at ~/.config/pastelocal/config.toml controls history size, TTL, and relay settings, so it is the right place to tune retention once the default workflow is working.
Verdict
PasteLocal is the strongest option for SSH clipboard sharing when your remote workflow depends on screenshots, history, and agent-friendly paste commands. Its key strength is that it preserves local clipboard context over the SSH channel you already use. The caveat is that it expects a local daemon and is still evolving. Use it if terminal-native remote development is your daily mode.



