CLI Reference

{
  "artifact_id": "art_01H...",
  "revision_id": "rev_01H...",
  "title": "My Publication Title",
  "artifact_url": "https://app.agent-paste.sh/artifacts/art_01H...",
  "revision_content_url": "https://usercontent.agent-paste.sh/v/...",
  "agent_view_url": "https://api.agent-paste.sh/v1/public/agent-view/...",
  "expires_at": "2026-06-20T00:00:00.000Z",
  "bundle": {
    "status": "pending",
    "retry_after_seconds": 5
  }
}
Command	Purpose
`agent-paste login`	Mint a browser-OAuth API Key with `publish` and `read` scopes.
`agent-paste logout`	Revoke the stored API Key when possible, then remove local credentials.
`agent-paste whoami`	Show the resolved Workspace, actor, and granted scopes.
`agent-paste publish <path>`	Upload files, publish a Revision, and print the result.
`agent-paste version`	Print the CLI version baked into the package or binary.
`agent-paste upgrade [<tag>]`	Self-update a standalone binary install.
Flag	Purpose
`--artifact-id <id>`	Publish a new Revision of an existing Artifact.
`--title <text>`	Set the display title. Defaults to the file or folder name.
`--entrypoint <path>`	Choose the file opened first by viewers.
`--render-mode <mode>`	Override inferred mode: `html`, `markdown`, `text`, `image`, `audio`, or `video`.
`--ephemeral`	Restricted accountless fallback for non-interactive text/images/static output. Ignores login/key, disables scripts until claimed, and prints a one-time claim link.
`--json`	Emit pure JSON on stdout. Errors still go to stderr.
`--quiet`	Suppress human-readable stdout.