Skip to content
agent-paste.sh
Get started
Docs

CLI Reference

The CLI is the primary publish surface for humans, agents, and CI.

Docs indexMarkdownFull text

Commands

CommandPurpose
agent-paste loginAuthenticate through browser OAuth.
agent-paste logoutRevoke and remove the stored credential.
agent-paste whoami --jsonReport authentication, Workspace, actor, and scopes.
agent-paste publish <path>Publish a file or folder and return one top-level url.
agent-paste pull <artifact-id> <path>Read one stored file.
agent-paste edit <artifact-id> <path>Apply literal edits and publish a Revision.
agent-paste versionPrint the CLI version.
agent-paste upgradeUpdate a standalone binary install.

Publish

agent-paste publish ./report --json
agent-paste publish ./report --artifact-id art_01H... --json

Every publish returns url. It opens without login on the Artifact's own capability subdomain. --artifact-id revises the Artifact without changing that URL.

✓ Published "report"

  View      https://0123456789abcdef0123456789abcdef.agent-paste.sh/
  Expires   <expiration date>

  Update    agent-paste publish ./report --artifact-id art_01H...

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

Accountless publish

Run whoami --json first. When login is unavailable or explicitly skipped, use publish <path> --ephemeral --json. Return url; return claim_url too when the human wants to keep the upload. Ephemeral HTML uses the same script-enabled top-level behavior.

Files and entrypoints

Directory publish preserves relative paths and skips .git, node_modules, .DS_Store, and .env*. Entrypoint inference is index.html, index.md, README.md, then the only file. Otherwise pass --entrypoint <path>.