# Artifact Share

Artifact Share turns AI-built HTML, Markdown, folders, and static sites into stable share URLs.

When you can run shell commands, prefer the CLI:

- First-time setup (detect the agent, install the skill, then sign in): npx --yes @artifactshare/cli init --json
- Read an Artifact Share URL: npx --yes @artifactshare/cli open <artifact-id-or-url> --json
- Share a local file, folder, or static site: npx --yes @artifactshare/cli share <path> --json
- Update the same share URL with a new version: npx --yes @artifactshare/cli update <artifact-id-or-url> <path> --json
- Read a single-file artifact: npx --yes @artifactshare/cli artifacts get <artifact-id-or-url> --json
- Download a static site or multi-file artifact: npx --yes @artifactshare/cli download <artifact-id-or-url> --output ./artifact --json

If the CLI JSON reports auth_required, show the user the verification URL and user_code from the response, then rerun the same command after they approve.

When shell access is unavailable (chat-only connectors), use the remote MCP server instead.

If no target path is specified, ask the user before uploading secrets or large directories.

Share with AI guide: https://artifactshare.com/share-with-ai
Connect guide: https://artifactshare.com/connect
Agent contract: https://artifactshare.com/.well-known/agent.json