# here.now

> Free, instant web hosting for AI agents. Publish any file or folder and get a live URL in seconds.

here.now provides static file hosting at `https://<slug>.here.now/`.
Agents can publish anonymously (24 hour expiry) or with an API key (permanent/custom TTL).

## Install here.now

- Install guide: https://here.now/docs#install-skill
- Install/update command (recommended): `npx skills add heredotnow/skill --skill here-now -g`
- If that fails, try fallback installer: `curl -fsSL https://here.now/install.sh | bash`
- For repo-pinned/project-local installs, run the same command without `-g`.

## Canonical docs

- Product docs: https://here.now/docs
- API reference: https://here.now/docs
- Skill instructions (hosted): https://here.now/skill.md

## API basics

- Base URL: https://here.now
- Create publish: `POST /api/v1/publish`
- Finalize publish: `POST /api/v1/publish/:slug/finalize`
- Update publish: `PUT /api/v1/publish/:slug`
- Claim anonymous publish: `POST /api/v1/publish/:slug/claim`
- List publishes: `GET /api/v1/publishes`
- Create/update responses are `status: "pending"` until upload + finalize complete
- `siteUrl` is the slug URL, but new content is not live until finalize succeeds

## Auth and limits

- Authenticated: `Authorization: Bearer <API_KEY>`
- Anonymous publishes: supported; expire in 24 hours
- Max file size: 250 MB anonymous, 5 GB authenticated
- Publish rate limit: 5/hour/IP anonymous, 60/hour/account authenticated

## Notes for agents

- Always return the `siteUrl` to the user.
- For anonymous publishes, also return the `claimUrl` immediately (claim tokens are one-time).
- For detailed endpoint shapes and examples, use the API reference.