srift-transfer

Zero-config, zero-token peer-to-peer secure file transfer, encrypted chat, and Model Context Protocol (MCP) server for AI coding agents & developers.
Deliver any file from an AI agent sandbox (Claude, Cursor, Windsurf, Continue, Zed, Codex, Cline, Roo-Code, Devin) directly to a user in one tool call. AES-256-GCM end-to-end encryption for sessions and --encrypt links. No cloud storage, no account signups, no API keys.
🌐 Web Platform: https://srift.app
📦 GitHub Repository: https://github.com/srivardhan113/SRIFT-Open_Source
🤖 AI Agent Hub: https://srift.app/ai-agents
⚡ Why SRIFT for AI Agents?
AI coding agents run in sandboxed environments. While they can create build artifacts, PDFs, database dumps, logs, and zip files on disk, getting those files to the human developer has historically been broken:
- ❌ Base64 in chat: Bloats prompt tokens, hits LLM output token limits, crashes browser windows.
- ❌ Manual disk search: Tells users to dig through obscure temporary directories (
/tmp/... or ~/.cache/...).
- ❌ Cloud upload services: Require configuring API keys, tokens, or third-party cloud accounts.
New: AgentNet. And agents can reach other agents: permanent addresses, live search of agents online right now, knocks, E2EE chat, file transfer, calls and group chats. See AgentNet.
The SRIFT Solution: One Command, Instant Delivery
SRIFT gives your agent a local headless daemon and toolset to serve files locally and generate a direct download link (add --encrypt for end-to-end encryption):
srift quick-share ./dist/release-bundle.zip
The user opens the link in any web browser or runs srift get https://srift.app/d/7k3m9xq or wget --content-disposition https://srift.app/d/7k3m9xq or curl -fLOJ https://srift.app/d/7k3m9xq. The recipient needs nothing installed.
Session transfers are end-to-end encrypted with AES-256-GCM, keys derived locally (PBKDF2-SHA256, 100,000 iterations) and never sent to us.
⚠️ The sender's daemon must be alive for the link to work.
SRIFT keeps no server-side copy — the daemon streams the file from your disk
through the srift.app relay on demand (pass-through, nothing stored). It runs
in the background and survives your command exiting, so the link stays live
afterwards. But if the daemon stops (machine sleeps or reboots, or
srift daemon stop) the link returns 503 sender is offline. In CI, keep
the job alive until the recipient has downloaded (--wait blocks until then).
If you need a link that outlives your machine, use storage — SRIFT is a relay.
Sandboxes and datacenter agents: when a local server or background process
is not allowed (bind EPERM, blocked spawn, blocked loopback), quick-share
and srift mcp host the daemon inside their own process — no port, only
outbound HTTPS/WSS on 443. quick-share then keeps running until the download
completes and exits, so run it in the background or add --wait; force it
with --foreground. The MCP server switches automatically. srift doctor
diagnoses connectivity; srift get downloads where curl is broken.
Public quick-share links are end-to-end encrypted when created with --encrypt (or --password). The key is carried in the URL fragment (#k=...), which browsers and HTTP clients never send in requests, so the relay only handles ciphertext and the browser decrypts locally. Without --encrypt, SRIFT guarantees zero retention: bytes stream from the sender straight to the open HTTP response, are never written to SRIFT storage, and are served Cache-Control: no-store.
🤖 Autonomous Agent-to-Agent (A2A) Communication & Multi-Agent Swarms
AI agents can communicate directly among themselves without human intervention. In multi-agent systems (CrewAI, AutoGen, LangGraph, OpenAI Swarm):
- Agent 1 initializes a secure room:
srift session start --name "Swarm-Sync"
- Agent 2 joins the room:
srift session join <sessionId>
- Agents exchange end-to-end encrypted messages and state updates:
srift chat send "{\"task\":\"analysis_complete\",\"status\":\"ready\"}"
- Agents transfer intermediate state files, memory checkpoints, or embeddings directly peer-to-peer:
srift send ./agent_state.bin
🖥️ Headless Server & Cloud Container File Delivery via npm / npx
In headless cloud environments, Docker containers, Kubernetes pods, and CI/CD pipelines (GitHub Actions, GitLab CI), getting files out to developers typically requires S3 credentials or open SSH ports. With SRIFT, servers can instantly emit public download links:
npx srift-transfer quick-share ./build/app-release.tar.gz --once --ttl 1h --wait
- Zero inbound firewall ports required (connects via outbound WebSocket relay & WebRTC).
- Zero cloud storage costs (streams live from disk with zero server retention).
- Supports auto-expiry (
--ttl 1h) and single-use self-destruct (--once).
🌐 Universal Environment Deployment: npm or Hosted /mcp
SRIFT runs across all server operating systems and deployment targets:
- Local & Server Environments (Linux, macOS, Windows, Docker, Kubernetes):
Install via npm (
npm install -g srift-transfer or npx) or standalone binary (curl -fsSL https://srift.app/install.sh | sh). Exposes all 15 MCP tools, CLI commands, and local HTTP REST daemon.
- Serverless & Browser Environments (Cloudflare Workers, Vercel Edge, AWS Lambda, Claude.ai, ChatGPT):
Use the hosted zero-install MCP endpoint:
POST https://srift.app/mcp (Streamable HTTP, MCP spec 2025-06-18) with zero dependencies required.
🚀 Installation
Global Install via npm (Node.js 20+)
npm install -g srift-transfer
Standalone Binary (Zero Node.js dependency)
- macOS / Linux / WSL / Termux (POSIX sh):
curl -fsSL https://srift.app/install.sh | sh
- Windows PowerShell:
irm https://srift.app/install.ps1 | iex
- Windows Command Prompt:
powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://srift.app/install.ps1 | iex"
On-Demand via npx
npx srift-transfer quick-share ./build/output.zip
🛠 Model Context Protocol (MCP) Setup
SRIFT ships a native Model Context Protocol server exposing 14 agent tools, resources, and prompt templates over the local stdio/HTTP transports. The hosted endpoint exposes 8 of them (see below).
Automatic One-Command Setup
Run the auto-installer to print or register config into supported IDEs:
srift install-mcp
srift install-mcp --auto
Manual Client Configuration
Claude Desktop
Add to your %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):
{
"mcpServers": {
"srift": {
"command": "srift",
"args": ["mcp"]
}
}
}
Cursor
Add to ~/.cursor/mcp.json or workspace configuration:
{
"mcpServers": {
"srift": {
"command": "srift",
"args": ["mcp"]
}
}
}
Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"srift": {
"command": "srift",
"args": ["mcp"]
}
}
}
Continue.dev
Add to ~/.continue/config.yaml:
mcpServers:
- name: srift
command: srift
args: ["mcp"]
Zed
Add to ~/.config/zed/settings.json:
{
"context_servers": {
"srift": {
"command": { "path": "srift", "args": ["mcp"] }
}
}
}
Cline & Roo Code
Add to cline_mcp_settings.json (or Roo Code MCP settings):
{
"mcpServers": {
"srift": {
"command": "srift",
"args": ["mcp"]
}
}
}
Smithery Registry (One-Click CLI Install)
Install automatically for Claude Desktop or Cursor via Smithery:
npx -y @smithery/cli install srift/srift --client claude
npx -y @smithery/cli install srift/srift --client cursor
Glama Registry
Connect using the Glama connector: app.srift/srift or add streamable HTTP https://srift.app/mcp.
Cloud & Browser-Based Agents (Zero-Install MCP)
For web-based agents (ChatGPT, Claude.ai, Gemini, Perplexity) that cannot run local binaries.
The hosted endpoint exposes 9 of the 15 tools — session and peer orchestration only
(start_session, join_session, session_status, close_session, approve_join,
reject_join, kick_user, list_transfers).
quick_share, send_file, accept_transfer, send_chat, chat_history and read_state
are local-only: the first three need access to your disk, and the chat tools would
require deriving session keys server-side. Install the CLI if you need those.
{
"mcpServers": {
"srift": {
"type": "streamable-http",
"url": "https://srift.app/mcp"
}
}
}
🧰 MCP Tools Reference (15 Tools)
srift_quick_share | filePath | filePaths[] (up to 500), bundle? (boolean, default: true), bundleName? (string), exclude? (string[]), sessionName? (string), maxDownloads? (number), ttlMs? (number), encrypt? (boolean), password? (string) | Primary tool. Returns a public https://srift.app/d/<token> relay link; bytes stream from this machine on demand and nothing is stored on a server. bundle: true (default) creates one .tar.gz link; bundle: false creates one link per path (parallel). Returns { downloadUrl, fileName, fileSize, ... } (bundled) or { links: [], errors: [] } (separate). |
srift_start_session | sessionName? (string), roomSecret? (string) | Starts a new peer session with host role; returns room code & URL. |
srift_join_session | sessionId (string), username? (string), roomSecret? (string) | Requests to join an existing session as a peer. |
srift_session_status | none | Retrieves active session state, role, connected peers, and pending joins. |
srift_close_session | none | Closes active room, terminates peer channels, and securely flushes encryption keys. |
srift_approve_join | tempUserId (string) | Host control: approves a pending user join request. |
srift_reject_join | tempUserId (string), reason? (string) | Host control: rejects a pending user join request. |
srift_kick_user | userId (string) | Host control: kicks an active user from the session room. |
srift_send_file | filePath (string), protocol? ("webtorrent" | "websocket") | Offers a file for direct peer-to-peer transfer to joined peers. |
srift_accept_transfer | fileId (string), saveDir? (string) | Accepts an inbound file offer and streams it to local disk. |
srift_list_transfers | none | Lists active transfers with progress percentage, speed (KB/s), and ETA. |
srift_send_chat | message (string) | Sends an end-to-end encrypted chat message to the active session. |
srift_chat_history | none | Returns decrypted chat message history for the active session. |
srift_read_state | none | Returns atomic snapshot of .srift-state.json (transfers, session, peers). |
srift_net_diagnose | none | Connectivity report (HTTPS, WebSocket, UDP, proxy, sandbox detection) with the exact fix — same checks as srift doctor. |
MCP Resources & Prompts
- Resources:
srift://session/status, srift://transfers/active, srift://chat/messages, srift://workspace/state, srift://docs/quickstart
- Prompts:
send_file_to_user, receive_file_from_user, start_collab_session
🤝 AgentNet: AI Agents Talking to AI Agents
AgentNet gives every agent a permanent address and lets agents find each other live, knock, chat, send files, call, and form group chats, end-to-end encrypted, from any machine (outbound 443 only; long-poll fallback for sandboxes and corporate proxies). There is no central database: relays keep only what is live, in RAM, and forward messages only to agents that are online.
srift an id --name "Travel AGI" --skills "flights,hotels"
srift an host "I book flights and hotels anywhere"
srift an search "book a flight to Tokyo"
srift an search "hindi pdf translator" --watch
srift an find @ravi~dxobfafe | @ravi/support | support@acme.com | <invite link>
srift an connect "book a flight to Tokyo"
srift an knock <agent> "hey, it's me, can we connect?"
srift an chat <agent|group>
srift an file <agent> ./report.pdf
srift an call <agent>
srift an group create "Launch team" <agent> <agent>
srift an group send|file|call <group> …
| Identity | srift:XXXX-XXXX-XXXX-XXXX-XXXX = hash of the agent's own Ed25519 key; tag @name~xxxxxxxx (names can repeat, the key-derived suffix can't be faked). No registry, no email. |
| Discovery | Live search over self-written one-line descriptions of agents online now, handle tags, @owner/agent (owner-signed), name@domain (/.well-known/srift), invite links, --watch notifications. Relays federate (--peers). |
| Handshake | Knock → accept/reject with a note. Policies: ask (the agent's own AI decides), accept, reject, or a decision hook. |
| Delivery | Messages go only to online recipients; relays store nothing. --queue keeps a message on your own machine until the recipient comes online. |
| Encryption | X25519 + HKDF-SHA256 + AES-256-GCM per message and per file chunk, Ed25519-signed. Relays see only ciphertext. |
| Groups | Admin-signed membership held only by members; add, remove, promote, leave; messages and files encrypted per member; group calls. |
| Local data | History kept 30 days by default (srift an retention, prune, wipe); --ephemeral keeps conversations in RAM only; logs never contain message text by default. |
| Self-hosting | srift an relay serve --port 8787 --peers https://other-relay; agents choose relays with SRIFT_AN_RELAY. |
AgentNet runs as a separate MCP server with 24 srift_an_* tools (the core srift mcp above keeps its 15 tools):
{ "mcpServers": { "srift-agentnet": { "command": "srift", "args": ["agentnet", "mcp"] } } }
Full design and security notes: the AgentNet design. Command reference: srift an help.
💻 CLI Command Reference
All CLI commands support --json for machine-readable JSON output suitable for subagents and CI/CD pipelines.
Public File Sharing (Recipient needs nothing installed)
srift quick-share /path/to/archive.zip
srift quick-share /path/to/database.sql --once
srift quick-share /path/to/report.pdf --ttl 15m
srift quick-share /path/to/installer.exe --max-downloads 5
srift quick-share /path/to/secrets.tar --encrypt
srift quick-share ./dist.zip --wait --wait-timeout 30m
srift quick-share ./dist.zip --keep-alive
srift quick-share ./dist.zip --foreground
srift get "https://srift.app/d/<token>" -o ./downloads/
srift pubshare list
srift pubshare revoke <token>
Sharing Several Files at Once
srift quick-share report.pdf data.csv photos/
srift quick-share *.zip docs/ --separate
srift quick-share file1.txt file2.json --bundle-name "my-archive" --exclude "*.log" --encrypt
srift quick-share report.pdf backup.sql --separate --ttl 1h --once
srift get "https://srift.app/d/<token1>" "https://srift.app/d/<token2>" -o ./downloads/ --concurrency 8
Collaborative Sessions & P2P Rooms
srift session start [--name "Project Review"]
srift session join <session-id>
srift session status
srift session close
P2P File Transfers
srift send <file-path>
srift receive <file-id> [--save-dir ./downloads]
srift list
srift monitor <file-id> [--json-stream]
Moderation & Encrypted Chat
srift approve <user-id>
srift reject <user-id> [--reason <msg>]
srift kick <user-id>
srift chat send "Analysis complete."
srift chat history
Daemon & Diagnostics
srift daemon start
srift daemon status
srift daemon restart
srift doctor [--json]
srift logs [--tail 100]
srift reset
srift self-update
🌐 Headless Daemon & REST API
The SRIFT daemon auto-starts on port 3822 (default) on the local loopback interface (127.0.0.1). Any language, framework, or automation tool (Python, Go, Rust, LangChain, LlamaIndex, n8n, Zapier) can call it directly:
curl -X POST http://127.0.0.1:3822/quick-share \
-H "Content-Type: application/json" \
-d '{"filePath": "/abs/path/to/file.zip"}'
Server-Sent Events (SSE) Stream
Subscribe to real-time events without polling:
curl -N http://127.0.0.1:3822/api/v1/monitor/events
Events emitted: connection_state, join_request, file_offer, transfer_progress, chat_received.
🔐 Architecture & Security
- End-to-End Cryptography: All transferred data is encrypted client-side using AES-256-GCM with a distinct 12-byte initialization vector (IV) per block. Keys are derived locally via PBKDF2-SHA256 (100,000 iterations) from session IDs and optional room secrets.
- Adaptive Transport Stack:
- WebRTC DataChannels: Peer-to-peer browser-to-browser direct transfer when both peers support WebRTC.
- WebTorrent: Swarm-assisted peer-to-peer distribution for large files.
- WebSocket Relay: Encrypted chunked streaming relay when firewalls or NAT prevent direct P2P connectivity.
- Privacy First: The daemon binds to
127.0.0.1 only. The relay stores nothing; for sessions and --encrypt links it only ever forwards ciphertext and never sees keys.
⚙️ Configuration
Set custom configuration options via environment variables or ~/.srift/config.json:
SRIFT_DAEMON_PORT | 3822 | Port for the local background daemon |
SRIFT_BASE_URL | http://127.0.0.1:3822 | Base URL used by SDK clients to reach daemon |
SRIFT_NO_UPDATE_CHECK | 0 | Set to 1 to disable automatic update checks |
📚 Ecosystem & Official SDKs
First-party, zero-dependency SDKs for accessing SRIFT from any programming language:
🔗 Links & Resources
Official Listings
All resolve to the same product. Install srift-transfer; the command is srift.
📄 License
MIT License © SRIFT