heresyour

Turn a folder of HTML into a live, shareable link in one command.

npx heresyour .
# ✓ live at  https://heresyour.site/brisk-otter-4f9c
# ✓ copied to your clipboard

The index.html at the top of what you upload becomes the page people land on.

Install

Use it with npx (no install), or globally:

npm install -g heresyour

Commands

heresyour [dir]          # publish a folder (default: current directory)
heresyour login          # sign in via the browser
heresyour logout         # forget the saved token
heresyour whoami         # show who you're signed in as

Options

| Flag | Description | |------|-------------| | --name, --slug <name> | Ask for a specific link name | | --entry <file.html> | Choose which HTML file is the landing page (no index.html needed) | | --password <word> | Lock the page behind a password | | --no-password | Remove the password when updating a link | | --json | Print the JSON result (for scripts/agents) | | -h, --help | Show help | | -v, --version | Show version |

Updating a link

Re-publish to a name you already own and the files are swapped in place — the URL stays the same. This works on any plan, even for an auto-generated name:

heresyour . --name q3-report      # updates heresyour.site/q3-report

An existing password is kept across updates unless you set a new one (--password …) or clear it (--no-password).

Auth

• Humans: heresyour login opens your browser, you approve, done. The token is saved to ~/.heresyour/config.json.
• CI / agents (Claude Code, Codex): set HERESYOUR_TOKEN (create a key in the dashboard). Browser login can't run headless.

Set HERESYOUR_API_BASE to point at a different backend (e.g. a local dev server).

Examples

heresyour ./dist --name q3-report
heresyour report.html --password swordfish
HERESYOUR_TOKEN=hyk_… heresyour . --json      # scripted / agent use