Skip to content
agent-paste.sh
Docs

Getting Started

Check auth, publish, and hand back one URL.

Install

npx @zaks-io/agent-paste whoami --json
npx @zaks-io/agent-paste publish ./report

npx needs Node.js 24+. Install @zaks-io/agent-paste globally for repeated use.

Authenticate

whoami --json exits 0 even when signed out, so check authenticated. If false, run login where a browser is available or login --device-code in a sandbox. See remote login.

Install the agent skill

The skill teaches Claude Code and Codex the publish, revise, ephemeral, and MCP workflows.

npx skills add https://github.com/zaks-io/agent-paste/tree/main/skills/agent-paste --agent claude-code codex

Publish

Publish uploads the file tree and returns url, which opens without login.

https://01234-56789-abcde-fghjd.agent-paste.link/

Pass --artifact-id 01234-56789-abcde-fghjd (or the full URL) to update the same website. Omit it to create a new Artifact.

Ephemeral fallback

npx @zaks-io/agent-paste publish ./report --ephemeral --json

Use this when login is unavailable or the user asks for accountless publishing. Return url, plus claim_url if the user wants to keep the upload. The Artifact expires in 24 hours and blocks scripts and network until claimed. See Ephemeral.