Vnsh

What is vnsh?

vnsh is a secure, ephemeral file-sharing service that encrypts data client-side with AES-256-CBC and auto-deletes after 24 hours—designed for AI workflows. It offers a first-party MCP server for Claude Code, allowing Claude to read encrypted links and share content without leaving the terminal.

How to use vnsh?

Install the MCP server by creating a .mcp.json file in your project root with "command": "npx", "args": ["-y", "vnsh-mcp"]. After restarting Claude Code, you can paste vnsh links for automatic reading, or use the tools vnsh_share (to share text outputs) and vnsh_share_file (to share images, PDFs, binaries). Alternatively, upload via the web, CLI (npx vnsh), a zero-install pipe script, a Chrome extension, or a GitHub Action.

Key features of vnsh

• Host-blind architecture: server stores only encrypted blobs, cannot decrypt
• Automatic vaporization: data disappears after 24 hours
• Client-side AES-256-CBC encryption; decryption keys stay in URL fragment
• Supports screenshots, logs, git diffs, binaries, and debug context
• First-party MCP server for Claude Code
• Self-hostable on Cloudflare Workers with R2 storage

Use cases of vnsh

• Share large logs (5000+ lines) with Claude without copy-paste
• Encrypt and share screenshots, PDFs, or config files for AI analysis
• Pipe git diff to vnsh for instant Claude-assisted PR reviews
• Automatically upload CI/CD failure logs and post secure links to PRs
• One-click AI debug bundles from the Chrome extension (screenshot + console errors)

FAQ from vnsh

How does vnsh keep data encrypted?

Encryption happens entirely on your device using AES-256-CBC. The decryption key is never sent to the server—it travels only in the URL fragment (#secret), which browsers never transmit over the network. The server stores only encrypted binary blobs and cannot decrypt them.

What data can I share through vnsh?

You can share any context: screenshots, long logs, git diffs, PDFs, CSVs, config files, database dumps, stack traces, environment dumps, crash reports, and binaries.

What is the MCP integration for Claude Code?

Install the vnsh MCP server via npx -y vnsh-mcp in your .mcp.json. Claude can then automatically read vnsh links you paste, and use the vnsh_share and vnsh_share_file tools to share text outputs or files directly.

Can I self-host vnsh?

Yes. vnsh runs on Cloudflare Workers with R2 storage. Clone the repository, create a R2 bucket and KV namespace, and deploy with Wrangler CLI. Edit wrangler.toml to customize the bucket and namespace bindings.

How does the URL structure work?

URLs use a compact v2 format: https://vnsh.dev/v/<12-char-id>#<64-char-base64url-secret>. The ID references the encrypted blob; the secret (key + IV) stays in the fragment and is never sent to the server. Legacy v1 URLs are still supported.