harvis

Deploy the current folder to harvis.dev with one command. No account, no config.

pip install harvis
harvis

or without installing (with uv):

uvx harvis

Output:

Uploading 3 files (12.4 KB)...

  Live site:   https://happy-panda-482.harvis.dev/
  Claim link:  https://harvis.dev/claim/xxxxxxxx-...

The claim link is private and single-use: open it and sign in to
manage the site. Run `harvis claim` to open it in your browser.

Commands

Options

• --name <name> — set the site name (defaults to the page <title>)
• --new — create a fresh site even if this project is already linked to one
• --token <token> — deploy token (or set HARVIS_DEPLOY_TOKEN)
• --subdomain <sub> — deploy to this site (or set HARVIS_SUBDOMAIN). Optional: the deploy token already names the site. When given, it must match the token's site, so it acts as a guard against deploying to the wrong one.
• --claim — open the claim link in your browser right after deploying

Updating a site

The first deploy creates a site and records it in two places:

• harvis.json at your project root — the site name only, no secrets. Commit it, and every clone of the project deploys to the same site.
• ~/.config/harvis/credentials.json — the deploy token, stored per user with 0600 permissions. Because it lives outside the project, rebuilding or deleting your output folder never loses it. (%APPDATA%\harvis\credentials.json on Windows; honours XDG_CONFIG_HOME, or HARVIS_CONFIG_DIR to override.)

Every later deploy from the same project sends that token and updates the same site — before and after you claim it. Claiming attaches the site to your account; the token keeps working, and you can view or regenerate it in the dashboard.

The project root is found by walking up from the folder being deployed, looking for harvis.json, .git, package.json, pyproject.toml and friends — so harvis deploy dist links the project, not the build output.

To deploy an existing site from another machine, link the project once. The token identifies the site by itself, so the subdomain is optional — the first deploy learns the name from the server and writes harvis.json:

harvis link --token <token-from-dashboard>
harvis

Name it as well if you want the check that you grabbed the right token — a mismatch fails the deploy instead of overwriting the other site:

harvis link happy-panda-482 --token <token-from-dashboard>

In CI, set the environment instead of running link. The token is the only secret needed:

export HARVIS_DEPLOY_TOKEN=<token-from-dashboard>
harvis deploy dist

To start over with a fresh URL, run harvis --new.

Uninstalling

Depending on how you installed it:

pip uninstall harvis          # pip install harvis
uv tool uninstall harvis      # uv tool install harvis
pipx uninstall harvis         # pipx install harvis

If you only ever ran uvx harvis, nothing was installed — drop the cached copy with uv cache clean harvis.

None of these remove your deploy tokens. To delete those too:

rm -rf ~/.config/harvis

(%APPDATA%\harvis on Windows, or wherever XDG_CONFIG_HOME / HARVIS_CONFIG_DIR points.) Tokens can also be regenerated from the dashboard, and harvis.json in a project is just the site name — delete it if you no longer want the project linked.

Notes

• Uploads are zipped when the folder compresses well (HTML/CSS/JS shrink ~60-70%); folders that are mostly already-compressed media (images, video, fonts) upload as raw multipart instead. A progress bar is shown on interactive terminals.
• Limits: 500 files, 50 MB per site. Hidden files and folders (anything starting with ., like .env or .git), node_modules, and OS junk files are skipped automatically.
• Unclaimed sites expire 24 hours after the last deploy. Claim a site to keep it online permanently. If a linked site has expired, the next deploy tells you and creates a new one.
• The deploy token is a secret and stays out of your project: it is written only to ~/.config/harvis/credentials.json, mode 0600. The harvis.json file in your project holds nothing but the site name and is safe to commit.
• The claim link is single-use and can't be recovered. If you want to keep the site, claim it before it expires.

Development

This package is managed with uv:

cd python
uv sync
uv run harvis --help
uv build

About

This CLI is the open-source companion to harvis.dev. Deploys are anonymous by default; opening the claim link and signing in attaches the site to your account so you can manage it from the dashboard.

License

MIT