Using a share link

Share links open directly in the browser. No account or software required.

Top bar

Every viewer page has a fixed top bar with:

• File type icon and filename
• File size and time until expiry
• Download button — always downloads the original file
• Dark/light toggle — preference is saved and applies to all future share links on your device

Tabs

Content types with multiple views use tabs that switch in place without reloading the page:

URL parameters

Agent / MCP tools

agent-share is registered as an MCP server in OpenClaw. Four tools are available in every agent session.

share_file

Upload a local file and get a public URL. The recipient sees the appropriate viewer for the file type.

share_file(path="/tmp/report.md", ttl="7d")
# returns: { url, slug, expires_at }

Common patterns

# Markdown report — renders with full formatting
share_file(path="/tmp/analysis.md", ttl="7d")

# Git diff — renders unified and side-by-side views
share_file(path="/tmp/changes.patch", ttl="24h")

# CSV data — renders as a sortable table
share_file(path="/tmp/results.csv", ttl="1h")

# Screenshot or diagram — displays inline
share_file(path="/tmp/diagram.png", ttl="24h")

# Permanent link with custom slug
share_file(path="/tmp/spec.md", name="project-spec", ttl="permanent")

share_tunnel

Expose a local HTTP port through a public URL. The tunnel is active for the duration of the tool call.

share_tunnel(port=5173, ttl="2h")
# returns: { url, slug }

list_shares

Returns all active shares and tunnels.

list_shares()
# returns: [{ slug, type, url, filename, size, created_at, expires_at }]

delete_share

Delete a share or disconnect a tunnel.

delete_share(slug="word-word-123")

CLI reference

The CLI provides the same capabilities as the MCP tools.

Setup

agent-share config set-server https://share.chesher.xyz
agent-share config set-key YOUR_API_KEY

Commands

file

agent-share file ./report.pdf
agent-share file ./image.png --name my-image --ttl 7d
agent-share file ./data.csv --ttl permanent

tunnel

agent-share tunnel 3000
agent-share tunnel 8080 --ttl 2h

list

agent-share list

rm

agent-share rm word-word-123

API reference

All endpoints require Authorization: Bearer YOUR_API_KEY.

Endpoints

POST /api/upload

Accepts multipart form data or a raw body with X-Filename header.

curl -X POST https://share.chesher.xyz/api/upload \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@report.pdf" \
  -F "ttl=7d" \
  -F "name=my-report"

Response:

{ "slug": "my-report", "url": "https://my-report.share.chesher.xyz",
  "filename": "report.pdf", "size": 124580,
  "expires_at": "2026-05-17T00:00:00Z" }

POST /api/tunnel

curl -X POST https://share.chesher.xyz/api/tunnel \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ttl":"2h"}'

Response:

{ "slug": "word-word-123",
  "url": "https://word-word-123.share.chesher.xyz",
  "ws_url": "wss://share.chesher.xyz/ws/tunnel/word-word-123",
  "expires_at": "..." }

Connect to ws_url with Authorization: Bearer to activate the tunnel.

Viewer types

The viewer detects file type by extension and MIME type and selects the appropriate renderer.

Supported types

URL parameters