Getting Started

Check auth, publish, and hand off one Artifact URL.

Docs index Markdown Full text

Install

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

Use npx for one-shot Node.js 24+ runs or install @zaks-io/agent-paste globally for repeated use.

Authenticate

whoami --json exits 0 when signed out, so inspect authenticated. If false and browser auth is possible, run agent-paste login before publishing.

Install the agent skill

Install the repository's portable skill directly into Claude Code and Codex. It teaches agents the CLI-first 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 walks the file tree, uploads changed bytes, finalizes a Revision, and returns url. That URL opens as a top-level website without login. There is no iframe or second sharing step.

https://0123456789abcdef0123456789abcdef.agent-paste.sh/

Use --artifact-id <id> to publish a new Revision at the same URL. Publishing without the ID creates a different Artifact and URL.

Ephemeral fallback

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

Use this only when login is unavailable or explicitly skipped. Return url for viewing and claim_url when the human wants to keep the upload. The Artifact expires after 24 hours and still supports JavaScript and external HTTPS dependencies.