# rapadura: hotsites for the community

**rapadura** publishes static hotsites to addresses like
`https://meetup-sobral.rapadura.net` or `https://conference.phpcomrapadura.org`
and looks after them afterwards: versions, rollback, logs. It is built to be
used from the terminal **or by your AI agent** (Claude Code, Cursor, Codex,
Claude Desktop).

## Three steps

1. **Install the CLI**

   ```sh
   curl -fsSL https://agents.rapadura.net/install.sh | sh
   ```

2. **Sign in with GitHub** (invite from the administrator required)

   ```sh
   rapadura login
   ```

3. **Publish a folder that has an `index.html`**

   ```sh
   rapadura publish ./my-site --site meetup-sobral --create --title "Meetup Sobral"
   ```

   Seconds later the site is live at `https://meetup-sobral.rapadura.net`.

Want your agent to do it for you? See [Connecting your agent](agents-setup.md).

## What you get

- **Your own address with automatic HTTPS** under `rapadura.net` or `phpcomrapadura.org`.
- **Immutable versions.** Every publish is a version; rolling back is one command.
- **No server to look after.** You never touch a machine, only the CLI.
- **Secure by default.** GitHub login, one revocable token per machine, and
  your agent only sees your own sites.
- **Built for agents.** Every command has `--json`, errors carry stable codes,
  and the same operations exist as MCP tools.

## Where to go

- [Getting started](getting-started.md): install, sign in, publish, update, roll back.
- [Connecting your agent](agents-setup.md): Claude Code, Cursor, Codex and hosted MCP.
- [WordPress sites](wordpress.md): subsites on the rapadura.net multisite, REST API and wp-cli through the agent.
- [Rules and limits](rules.md): what can go in a site, names, sizes, security.
- [Troubleshooting](troubleshooting.md): what to do when something fails.
- [What's next](roadmap.md): approvals, custom domains, restore and more.
- [CLI reference](../cli/rapadura.md) and [error codes](../errors.md).