# Beam Shares

> Beam Shares is Beam's internal portal for browser-native HTML artifacts and reusable templates.

## Agent access

Artifact source access is restricted to verified @beam.ai users. A public or external share link does not grant CLI or API access.

For an internal artifact URL such as:

https://shares.beam.ai/a/<slug>

the authenticated agent guide is available at:

https://shares.beam.ai/a/<slug>/agent.md

That Markdown endpoint accepts either a signed-in Beam browser session or a Beam Shares bearer credential. It returns 401 or 403 without a verified @beam.ai identity and follows the same shared/private artifact visibility rules as the portal.

## Preferred retrieval

Use the Beam Shares repository CLI rather than scraping the browser page:

node scripts/beam-shares.mjs auth status --json
node scripts/beam-shares.mjs artifacts download "https://shares.beam.ai/a/<slug>" --output ./beam-shares-source.zip

Browser and CLI authentication are separate. A browser redirect to /login does not prove the CLI/API source is unavailable. Run auth login only when the stored credential is missing, expired, or revoked. Never request or paste a Beam Shares token in chat.