# rapadura: hotsites para a comunidade

O **rapadura** publica hotsites estáticos em endereços como
`https://meetup-sobral.rapadura.net` ou `https://conference.phpcomrapadura.org`,
e cuida deles depois: versões, volta de versão, logs. Foi feito para você
usar direto no terminal **ou pelo seu agente de IA** (Claude Code, Cursor,
Codex, Claude Desktop).

## Em três passos

1. **Instale a CLI**

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

2. **Entre com o GitHub** (precisa de convite do administrador)

   ```sh
   rapadura login
   ```

3. **Publique uma pasta com `index.html`**

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

   Em segundos o site está em `https://meetup-sobral.rapadura.net`.

Quer que o seu agente faça isso por você? Veja [Conectando seu agente](agentes.md).

## O que você ganha

- **Endereço próprio e HTTPS automático** em `rapadura.net` ou `phpcomrapadura.org`.
- **Versões imutáveis.** Cada publicação vira uma versão; voltar é um comando.
- **Sem servidor para cuidar.** Você não acessa máquina nenhuma, só a CLI.
- **Seguro por padrão.** Login pelo GitHub, token por máquina (revogável), e o
  seu agente só enxerga os seus sites.
- **Feito para agentes.** Toda saída tem `--json`, os erros têm códigos
  estáveis, e as mesmas operações existem como ferramentas MCP.

## Para onde ir

- [Começando](comecando.md): instalar, entrar, publicar, atualizar, voltar versão.
- [Conectando seu agente](agentes.md): Claude Code, Cursor, Codex e MCP hospedado.
- [Sites WordPress](wordpress.md): subsites no multisite de rapadura.net, API REST e wp-cli pelo agente.
- [Regras e limites](regras.md): o que pode ir no site, nomes, tamanhos, segurança.
- [Problemas comuns](problemas.md): o que fazer quando algo dá errado.
- [O que vem por aí](roadmap.md): aprovações, domínio próprio, restauração e mais.
- [Referência da CLI](../cli/rapadura.md) (em inglês) e [códigos de erro](../errors.md).