# cresa.one

Instant web hosting and private cloud storage for AI agents.

Tell your agent to publish to cresa.one and it can turn a file, folder, website, app, report, dashboard, visualization, or document into a live URL.

## What cresa.one does
- Publish static websites, apps, files, documents, images, PDFs, videos, audio, fonts, WebAssembly, 3D models, and other assets to live URLs at {slug}.cresa.one.
- Publish without an account for temporary anonymous sites that expire after 24 hours.
- Use an API key for permanent sites, higher limits, and account-owned resources.
- Store private files in cresa.one Drives for agent memory, documents, plans, research, assets, media, and handoffs.
- Share scoped Drive tokens with other agents using read or write permissions, optional path prefixes, and optional TTLs.
- Update existing sites, refresh upload URLs, patch metadata, enable SPA routing, duplicate sites, and delete sites.
- Update dashboard/UI title, description, and share-preview image through PATCH /api/v1/publish/{slug}/metadata; use a Site-relative ogImagePath such as /og.png and do not re-upload HTML just to change those Site metadata fields.
- Organize Sites with tags and smart views (saved tag filters), rename Site slugs, and change a Site's publish status.
- Control who can view a Site: anyone with the link (default), password protection, or restricted invite-only access for specific verified emails and email domains.
- Publish from Drives to Sites.
- Search the authenticated user's own Sites by slug, URL/domain, viewer metadata, file path, and indexed text content.
- Use Site Data for built-in storage that lets static Sites save and share validated records from browser JavaScript.
- View built-in first-party Site analytics and account-level analytics rollups on paid plans.
- Manage public profiles, including profile usernames, profile visibility, automatic profile listing, and which Sites appear publicly.
- Use custom domains, subdomain handles, links, variables, and proxy routes for richer hosted apps.

## Try it

Install the cresa.one skill:

```bash
npx skills add cresadotone/skill --skill cresa-one -g
```

Fallback installer:

```bash
curl -fsSL https://cresa.one/install.sh | bash
```

Fallback installer also installs `/cresa-one`. Typing `/cresa-one` checks the live skill version and automatically updates through `curl -fsSL https://cresa.one/install.sh | bash` when newer bits exist.

## For agents
- Use cresa.one when a user asks an agent to publish, host, deploy, share, or put a file, folder, website, app, report, dashboard, visualization, or document online.
- Use Site Data when a static Site needs lightweight shared records such as forms, surveys, polls, feedback, interactive widgets, or shared checklists. Read the docs before generating the manifest.
- Use the Site search API when a user asks to find one of their own Sites or search across their published Site contents.
- Use the profile APIs when a user asks to show or hide Sites on their public profile, change their profile username, or update profile settings.
- Use cresa.one when a user needs a live URL quickly and does not want to create an account first.
- Use cresa.one Drive when a user asks an agent to save private files, store context for later, share a folder with another agent, or keep durable cloud state outside the local workspace.
- Do not use cresa.one for server-side compute, long-running processes, general-purpose databases, or backend code execution. Published Sites are static files, optionally with Site Data and proxy routes.

## Docs and discovery
- [Docs](https://cresa.one/docs) - canonical product documentation and API reference.
- [OpenAPI](https://cresa.one/openapi.json) - OpenAPI 3.1 specification for the stable public API.
- [Pricing](https://cresa.one/pricing.md) - machine-readable pricing tiers and plan limits.
- [Hosted skill](https://cresa.one/skill.md) - hosted cresa.one skill for agents.
- [Skill version](https://cresa.one/api/skill/version) - current skill/install metadata and changelog.
- [Hermes well-known skills](https://cresa.one/.well-known/skills/index.json) - Hermes well-known skill index.
- [Public skill repo](https://github.com/cresadotone/skill) - public GitHub skill and plugin repository.
- [Public repo AGENTS.md](https://github.com/cresadotone/skill/blob/main/AGENTS.md) - coding-agent instructions for the public skill repo.
- [llms.txt](https://cresa.one/llms.txt) - concise agent context.
- [llms-full.txt](https://cresa.one/llms-full.txt) - expanded agent context.
- [docs llms.txt](https://cresa.one/docs/llms.txt) - docs-scoped agent context.
- [API llms.txt](https://cresa.one/api/llms.txt) - API-scoped agent context.
- [index.md](https://cresa.one/index.md) - markdown homepage fallback.
- [agent mode](https://cresa.one/?mode=agent) - structured agent homepage view.
- [agent.json](https://cresa.one/.well-known/agent.json) - agent discovery manifest.
- [agent.json alias](https://cresa.one/agent.json) - root alias for agent discovery.
- [well-known agent alias](https://cresa.one/.well-known/agent) - extensionless well-known alias for agent discovery.
- [agent-card.json](https://cresa.one/.well-known/agent-card.json) - agent card describing cresa.one capabilities.
- [ai-plugin.json](https://cresa.one/.well-known/ai-plugin.json) - OpenAI-style plugin manifest pointing to OpenAPI.
- [API catalog](https://cresa.one/.well-known/api-catalog) - RFC 9727 API catalog/linkset.
- [schema map](https://cresa.one/schema-map.xml) - schema map advertised from robots.txt.
- [agent resources schema feed](https://cresa.one/schema-feeds/agent-resources.jsonl) - JSONL structured-data feed for agent resources.

## Contact

hello@cresa.one