artidrop

CLI to publish and share HTML, Markdown, and multi-file sites with a single command.

Install

npm install -g artidrop

Quick start

# Sign in (opens browser)
artidrop login

# Publish a file
artidrop publish ./report.html

# Publish markdown
artidrop publish ./notes.md --title "Meeting Notes"

# Publish a multi-file site (directory or ZIP)
artidrop publish ./my-site/
artidrop publish ./site.zip --title "Portfolio"

Agent / CI usage

For non-interactive environments, set an API key instead of using artidrop login:

export ARTIDROP_API_KEY="sk-your-api-key"

Pipe generated content from an AI agent:

echo "<h1>Hello</h1>" | artidrop publish - --format html --title "Generated Report" --json

Commands

| Command | Description | |---------|-------------| | artidrop publish <path> | Publish a file, directory, or ZIP (- for stdin) | | artidrop list | List your artifacts | | artidrop get <id> | Show artifact details | | artidrop delete <id> | Delete an artifact | | artidrop versions <id> | Show version history | | artidrop login | Sign in to artidrop | | artidrop logout | Sign out | | artidrop whoami | Show current user |

Publish options

-t, --title <title>        Artifact title (default: filename)
-f, --format <format>      html or markdown (auto-detected from extension; ignored for directories/ZIPs)
-v, --visibility <vis>     public, unlisted, or private (default: unlisted)
-u, --update <id>          Update existing artifact (new version)
-o, --open                 Open URL in browser after publishing
-c, --copy                 Copy URL to clipboard
    --json                 Output full JSON response

Configuration

Credentials are stored in ~/.config/artidrop/config.json after artidrop login.

Environment variables take precedence over the config file:

• ARTIDROP_API_KEY — API key for authentication
• ARTIDROP_API_URL — Custom API endpoint (default: https://api.artidrop.ai)

License

MIT