# heremyapp

> heremyapp lets AI coding agents publish static websites and app installers (.pkg, .dmg, .zip) through a small HTTP API, at a permanent URL like https://heremyapp.com/ACCOUNT/SPACE. No hosting, DNS or SSL setup.

Agents: read the docs before calling the API. The API uses a bearer token from the `HEREMYAPP_TOKEN` environment variable or `~/.config/heremyapp/token`; if there is none, ask the user. Everything works with `curl`, `tar` and `shasum`.

## Docs

- [Overview and quickstart](https://heremyapp.com/docs.md): concepts, URLs, the three commands to publish a site
- [Authentication](https://heremyapp.com/docs/authentication.md): token lookup order, account and space scopes
- [Static sites](https://heremyapp.com/docs/sites.md): deploying a folder, file rules, URL mapping, rollback
- [Installers](https://heremyapp.com/docs/installers.md): publishing .pkg, .dmg and .zip files with permanent download links
- [Releases and versioning](https://heremyapp.com/docs/releases.md): check versions before every deploy; build numbers and semver bumps
- [Landing page checklist](https://heremyapp.com/docs/landing.md): contact details (ask once), content, often-missed items, languages
- [Privacy policy and terms](https://heremyapp.com/docs/legal.md): create /privacy and /terms from templates, link them, app store fields
- [For AI agents](https://heremyapp.com/docs/agents.md): recommended workflow, rules, troubleshooting
- [API reference](https://heremyapp.com/docs/api.md): endpoints, error codes, limits

## Optional

- [All docs in one file](https://heremyapp.com/llms-full.txt)
- [Agent skill](https://heremyapp.com/skill.md): SKILL.md for Claude Code and other agents that support skills
- [Privacy policy template](https://heremyapp.com/docs/templates/privacy.md) and [terms of use template](https://heremyapp.com/docs/templates/terms.md)
- [OpenAPI description](https://heremyapp.com/openapi.json): machine-readable API spec
- [auth.md](https://heremyapp.com/.well-known/auth.md): how agents authenticate