# bohr

> A bohr publica um repositório do GitHub como um Worker da Cloudflare e deixa um agente de IA mudá-lo por conversa (no painel web ou no Telegram). Cada mudança vai primeiro para uma homologação e só chega à produção quando alguém aprova. A bohr é open source e auto-hospedada, ou roda para você como bohr.io Cloud (app.bohr.io).

Os projetos rodam na conta da Cloudflare do dono; o código fica no repositório dele no GitHub. A CLI `bohr` (npm `bohr`) publica a partir de um terminal, scripts, CI e agentes de IA de programação; `bohr-io/deploy-action@v1` publica pelo GitHub Actions.

Cada link abaixo é a cópia em Markdown de uma página. A documentação inteira num arquivo: https://docs.bohr.io/pt-br/llms-full.txt. Em inglês: https://docs.bohr.io/llms.txt.

## Introdução

- [Como funciona](https://docs.bohr.io/pt-br/introduction/how-it-works.md): De um repositório do GitHub até a produção, passando pelo agente, pela homologação e por uma aprovação.
- [bohr.io Cloud ou auto-hospedada](https://docs.bohr.io/pt-br/introduction/cloud-and-self-hosted.md): As duas formas de rodar a bohr, o que cada uma inclui e pelo que você paga.
- [O que você precisa](https://docs.bohr.io/pt-br/introduction/requirements.md): As contas e os planos de que cada pessoa precisa para usar a bohr.

## Primeiros passos

- [Entrar](https://docs.bohr.io/pt-br/getting-started/sign-in.md): Entre na bohr com o GitHub ou com um código enviado por e-mail e siga o assistente de Primeiros passos.
- [Conectar a Cloudflare](https://docs.bohr.io/pt-br/getting-started/connect-cloudflare.md): Crie o token de API da Cloudflare de que a bohr precisa, com as permissões certas, e conecte a sua conta.
- [Instalar o app do GitHub](https://docs.bohr.io/pt-br/getting-started/install-github-app.md): Dê à bohr acesso aos repositórios que ela pode usar, pelo app do GitHub dela.
- [Criar um projeto a partir de um repositório](https://docs.bohr.io/pt-br/getting-started/create-project.md): Transforme um dos seus repositórios do GitHub em um projeto da bohr.
- [Começar por um modelo](https://docs.bohr.io/pt-br/getting-started/templates.md): Crie um projeto a partir de um dos sites prontos da bohr, com repositório e banco de dados D1 próprios.
- [Primeiro deploy](https://docs.bohr.io/pt-br/getting-started/first-deploy.md): Como o agente prepara o seu repositório e como o seu site chega à produção pela primeira vez.
- [O seu primeiro pedido](https://docs.bohr.io/pt-br/getting-started/first-request.md): Peça uma mudança ao agente, revise na homologação e publique.

## O agente

- [Chat no painel](https://docs.bohr.io/pt-br/agent/chat.md): Converse com o agente na página Agente do projeto ou ao lado da visualização do site, acompanhe o trabalho dele e responda às perguntas dele.
- [Telegram](https://docs.bohr.io/pt-br/agent/telegram.md): Converse com o agente e aprove publicações pelo bot do Telegram do projeto, e os comandos que ele entende.
- [A homologação](https://docs.bohr.io/pt-br/agent/previews.md): Revise as mudanças do agente na homologação e depois aprove para a produção ou descarte.
- [Versões e reversão](https://docs.bohr.io/pt-br/agent/versions-and-rollback.md): Todas as publicações que a bohr fez, e como voltar a produção para a versão anterior.
- [Provedores de modelo](https://docs.bohr.io/pt-br/agent/providers.md): Dê vida ao agente com uma chave da API da Anthropic, um endpoint compatível com a Anthropic ou a sua assinatura Claude Pro/Max.
- [O que o agente pode e não pode fazer](https://docs.bohr.io/pt-br/agent/capabilities.md): As ferramentas do agente, o sandbox dele e os limites que a bohr coloca em volta dele.
- [Custos e limites](https://docs.bohr.io/pt-br/agent/costs-and-limits.md): Quanto custa cada pedido, os limites de orçamento e de turnos, e como mudá-los.
- [Dicas para bons pedidos](https://docs.bohr.io/pt-br/agent/tips.md): Como pedir para o agente acertar de primeira.

## Projetos

- [A página do projeto](https://docs.bohr.io/pt-br/projects/overview.md): A lista de projetos, o menu do projeto e a visão geral.
- [Builds](https://docs.bohr.io/pt-br/projects/builds.md): As execuções do GitHub Actions no repositório do projeto, com os jobs e os logs.
- [Membros e papéis](https://docs.bohr.io/pt-br/projects/members.md): Convide pessoas para um projeto com códigos de uso único e gerencie quem tem acesso.
- [Configurações do projeto](https://docs.bohr.io/pt-br/projects/settings.md): As páginas Geral, Agente e Hospedagem das configurações de um projeto.
- [Variáveis de ambiente](https://docs.bohr.io/pt-br/projects/variables.md): Variáveis do site para o Worker de produção e variáveis do build para o build no GitHub Actions, inclusive secrets.
- [Proteção por senha](https://docs.bohr.io/pt-br/projects/password-protection.md): Peça usuário e senha (Basic Auth) aos visitantes antes de abrirem o site.
- [Domínios próprios](https://docs.bohr.io/pt-br/projects/domains.md): Ligue domínios da sua conta da Cloudflare ao site de produção.
- [Excluir um projeto](https://docs.bohr.io/pt-br/projects/delete.md): Remova um projeto e tudo o que a bohr criou para ele, mantendo ou apagando o site publicado.

## Deploys

- [Como os deploys funcionam](https://docs.bohr.io/pt-br/deploys/how-deploys-work.md): Como um projeto da bohr faz o build e publica na Cloudflare, e os arquivos que descrevem isso.
- [O workflow de deploy](https://docs.bohr.io/pt-br/deploys/deploy-workflow.md): O workflow do GitHub Actions que a bohr escreve a partir do .bohr/deploy.json, passo a passo.
- [.bohr/deploy.json](https://docs.bohr.io/pt-br/deploys/deploy-json.md): Referência do arquivo que descreve como a bohr faz o build e o deploy de produção.
- [.bohr/preview.json](https://docs.bohr.io/pt-br/deploys/preview-json.md): Referência do arquivo que diz à bohr como rodar o servidor de desenvolvimento da homologação no sandbox do agente.
- [Config do wrangler e bindings](https://docs.bohr.io/pt-br/deploys/wrangler-config.md): A config do wrangler que a bohr publica, os bindings que cada tipo de projeto aceita e o que é ignorado.
- [Bancos de dados D1 e migrations](https://docs.bohr.io/pt-br/deploys/d1-databases.md): Use o Cloudflare D1 num projeto da bohr, e como as migrations rodam em cada deploy.
- [Monorepos e pastas de trabalho](https://docs.bohr.io/pt-br/deploys/monorepos.md): Faça o deploy de um projeto que fica numa subpasta do repositório.

## CLI

- [Instalar a CLI](https://docs.bohr.io/pt-br/cli/install.md): Instale a CLI do bohr (pacote npm bohr) ou rode com npx.
- [Autenticação](https://docs.bohr.io/pt-br/cli/authentication.md): Entre na CLI com bohr login, use um token do painel com BOHR_TOKEN, ou o OIDC do GitHub no Actions.
- [bohr deploy](https://docs.bohr.io/pt-br/cli/deploy.md): Faça o build e o deploy de uma pasta como homologação de um branch, ou como produção com --prod.
- [Comandos](https://docs.bohr.io/pt-br/cli/commands.md): Todos os comandos da CLI do bohr, com opções e exemplos.
- [Saída JSON](https://docs.bohr.io/pt-br/cli/json-output.md): A saída --json de cada comando, para scripts e agentes de IA.
- [Códigos de saída e erros](https://docs.bohr.io/pt-br/cli/exit-codes.md): O que significa cada código de saída e código de erro da CLI do bohr, e o que fazer.
- [Uso em CI](https://docs.bohr.io/pt-br/cli/ci.md): Rode bohr deploy no GitHub Actions e em outros sistemas de CI.
- [Variáveis de ambiente](https://docs.bohr.io/pt-br/cli/environment-variables.md): As variáveis de ambiente que a CLI do bohr lê.

## GitHub Action

- [Referência da bohr-io/deploy-action](https://docs.bohr.io/pt-br/github-action/reference.md): Inputs, outputs e modos da GitHub Action bohr-io/deploy-action@v1.
- [Exemplos](https://docs.bohr.io/pt-br/github-action/examples.md): Workflows que usam a bohr-io/deploy-action@v1.

## Para agentes de IA

- [Deploy a partir de agentes de IA de programação](https://docs.bohr.io/pt-br/ai-agents/overview.md): Como Claude Code, Cursor, Codex e outros agentes de programação fazem deploy de projetos da bohr com a CLI.
- [Configurar um token para um agente](https://docs.bohr.io/pt-br/ai-agents/setup.md): Crie um token da bohr com escopo e entregue a um agente de IA sem expô-lo.
- [O ciclo de deploy](https://docs.bohr.io/pt-br/ai-agents/deploy-loop.md): Como um agente de IA deve chamar a CLI, ler o JSON, reagir aos códigos de saída, e quando (não) fazer deploy de produção.
- [Trecho para AGENTS.md / CLAUDE.md](https://docs.bohr.io/pt-br/ai-agents/agents-md.md): Instruções para copiar e colar que ensinam um agente de programação a fazer deploy do seu projeto com a CLI do bohr.
- [SKILL.md para agentes](https://docs.bohr.io/pt-br/ai-agents/skill.md): Um arquivo de skill no formato de skills do Claude Code com tudo o que um agente de IA precisa para fazer deploy de projetos da bohr.

## Organizações

- [Organizações](https://docs.bohr.io/pt-br/organizations/overview.md): Trabalhe em equipe numa organização da bohr, que espelha uma organização do GitHub.
- [Membros e papéis da organização](https://docs.bohr.io/pt-br/organizations/members.md): Como os membros da organização espelham o GitHub, os papéis deles e como mudar ou remover o acesso.
- [Configurações e cobrança da organização](https://docs.bohr.io/pt-br/organizations/settings-and-billing.md): A conta da Cloudflare, o agente e a assinatura de uma organização, e como excluí-la.

## Conta

- [Sua conta e conexões](https://docs.bohr.io/pt-br/account/connections.md): Perfil, idioma, formas de entrar e como desconectar o GitHub, o Telegram, a Cloudflare e o agente.
- [Tokens](https://docs.bohr.io/pt-br/account/tokens.md): Crie, limite e revogue tokens para a CLI da bohr, scripts e agentes de IA.
- [Excluir sua conta](https://docs.bohr.io/pt-br/account/delete-account.md): Remova a sua conta da bohr e tudo o que a bohr criou para ela.

## Assinatura

- [Assinatura](https://docs.bohr.io/pt-br/billing/subscription.md): A assinatura do bohr.io Cloud, o que ela inclui e como gerenciá-la.

## Auto-hospedagem

- [Visão geral da auto-hospedagem](https://docs.bohr.io/pt-br/self-hosting/overview.md): Rode a sua própria instância da bohr na sua conta da Cloudflare, e quanto isso custa.
- [Fazer o deploy da instância](https://docs.bohr.io/pt-br/self-hosting/deploy-instance.md): Instale uma instância da bohr com o botão Deploy to Cloudflare ou com o wrangler.
- [O app do GitHub da instância](https://docs.bohr.io/pt-br/self-hosting/github-app.md): Crie o app do GitHub que a sua instância usa, e as permissões que ele pede.
- [Referência de configuração](https://docs.bohr.io/pt-br/self-hosting/configuration.md): Os secrets, as variáveis e os bindings que uma instância auto-hospedada da bohr lê.
- [Recursos opcionais](https://docs.bohr.io/pt-br/self-hosting/optional-features.md): O bot da plataforma no Telegram, o login por e-mail, o container de login dedicado e a sua própria imagem do agente.
- [Administração](https://docs.bohr.io/pt-br/self-hosting/administration.md): Os administradores da instância, a área de Administração do painel e a API de administração.
- [Atualizações e backups](https://docs.bohr.io/pt-br/self-hosting/updates-and-backups.md): Atualize a sua instância e os runtimes dos projetos, faça backup do banco de dados e rotacione a chave mestra.
- [Telemetria](https://docs.bohr.io/pt-br/self-hosting/telemetry.md): A telemetria anônima e opcional das instâncias auto-hospedadas, o que ela envia e como mantê-la desligada.

## Migração da bohr v1

- [Projetos da bohr v1 na bohr v2](https://docs.bohr.io/pt-br/migrating-from-v1/overview.md): O que aconteceu com os projetos da bohr v1, e o que você pode fazer agora.
- [O que muda para um projeto da v1](https://docs.bohr.io/pt-br/migrating-from-v1/what-changes.md): Como um projeto migrado faz build, deploy e é servido enquanto a bohr o hospeda.
- [Mover para a sua conta da Cloudflare](https://docs.bohr.io/pt-br/migrating-from-v1/move-to-your-cloudflare.md): Mova um projeto que a bohr hospeda para a sua própria conta da Cloudflare, com os secrets e os domínios dele.
- [Perguntas frequentes sobre a migração](https://docs.bohr.io/pt-br/migrating-from-v1/faq.md): Dúvidas comuns dos clientes da bohr v1.

## Referência

- [Glossário](https://docs.bohr.io/pt-br/reference/glossary.md): As palavras que a bohr usa, em inglês e no painel em português.
- [Solução de problemas](https://docs.bohr.io/pt-br/reference/troubleshooting.md): Erros comuns, com as mensagens exatas que a bohr mostra, e como resolvê-los.
- [Limites](https://docs.bohr.io/pt-br/reference/limits.md): Todos os limites de tamanho, tempo e quantidade da bohr, num só lugar.
- [Modelo de segurança](https://docs.bohr.io/pt-br/reference/security.md): O que a bohr pode acessar, como as credenciais são guardadas e por que o agente não consegue publicar nem vazar as suas chaves.

## Arquivos para agentes de IA

- [AGENTS.md](https://docs.bohr.io/pt-br/downloads/AGENTS.md): Trecho de AGENTS.md / CLAUDE.md que ensina um agente de programação a publicar com a CLI do bohr
- [SKILL.md](https://docs.bohr.io/pt-br/downloads/bohr-deploy/SKILL.md): SKILL.md: instruções que um agente de IA carrega para publicar projetos bohr (formato de skill do Claude Code)

## Optional

- [Documentação da bohr](https://docs.bohr.io/pt-br/index.md): A bohr faz o deploy do seu repositório do GitHub na Cloudflare e deixa um agente de IA mudá-lo por conversa, com uma homologação que você aprova antes de qualquer coisa chegar à produção.
- [Histórico de mudanças](https://docs.bohr.io/pt-br/changelog.md): O que mudou na bohr, versão por versão, a partir da bohr v2.