Sua pasta
Onde o Casper guarda carrosséis e como mantém sync com seu assistente.
O Casper é pasta primeiro. Você escolhe um diretório no computador; o app e seu assistente usam o mesmo lugar. Quando o assistente atualiza um arquivo, o Casper mostra as telas novas.
Abrir ou trocar pasta
Na barra lateral do Casper:
- Abrir workspace… — primeira configuração ou após instalar.
- Trocar workspace… — mudar para outro projeto ou caminho na máquina.
O Casper espera uma pasta de projeto normal com diretório slides/. Se o slide kit
estiver ausente, o app oferece sincronizar — aceite uma vez para o assistente ter
as skills e comandos certos do Casper.
O sync atualiza o slide kit (skills, workflows, regras do assistente). Não apaga seus carrosséis, arquivos do repositório ou temas customizados — veja O que o sync altera abaixo.
Mesma pasta no assistente
Seu assistente precisa trabalhar nessa pasta exata — não uma cópia, não um export.
Configuração típica:
- Abra a pasta no Cursor, Claude Code, Codex ou similar.
- Abra a mesma pasta no Casper (Abrir workspace…).
- Briefe o assistente; veja as prévias atualizarem no Casper.
O que fica na pasta
Você não precisa editar isso à mão — seu assistente faz — mas ajuda saber o que o Casper lê:
| Item | Finalidade |
|---|---|
slides/ | Uma subpasta por deck de carrossel. |
repository/ | Texto-fonte e PDFs que o assistente lê ao montar decks. |
repository/SOUL.md | Voz da marca — tom, vocabulário, CTA padrão (veja Repositório). |
themes/ | Temas visuais compartilhados do workspace (opcional). |
themes/custom/ | Seus temas — seguros em atualizações do kit (veja Temas e layouts). |
assets/ | Imagens reutilizadas entre decks (opcional). |
| Slide kit | Skills e regras do assistente (/casper-help, /create-slide, /edit-slide, etc.). |
Decks aparecem em Slides no Casper assim que os arquivos são escritos ou atualizados.
O que o sync altera (e o que nunca mexe)
Ao abrir workspace, trocar pasta ou aceitar sync do kit na barra lateral, o Casper mescla um slide kit atualizado na pasta. Isso mantém comandos e skills do assistente atuais após update do app.
Não é reinstalação completa. O Casper não apaga a pasta e copia tudo de novo. Atualiza arquivos gerenciados do pacote do app e remove arquivos do kit que não vêm mais no app (skills, workflows ou agents antigos). Seus carrosséis e corpus ficam intactos.
Seu trabalho (seu — nunca apagado)
| Caminho | Seu? | Comportamento do sync |
|---|---|---|
slides/ | Sim | Nunca alterado |
repository/ | Sim | Nunca alterado (templates ausentes podem ser adicionados uma vez) |
project.json | Sim | Nunca alterado |
themes/custom/ | Sim | Nunca alterado — coloque temas pessoais aqui |
.agent/custom/ | Sim | Suas skills, agents, workflows locais — nunca removidos ou sobrescritos |
Slide kit (gerenciado — atualizado pelo Casper)
| Caminho | Comportamento do sync |
|---|---|
.agent/ (exceto custom/) | Mesclado do app — workflows como /create-slide, skills, agents |
| Removido do app | Podado no próximo sync — comandos slash obsoletos somem do kit gerenciado |
.cursor/, .claude/, .agents/ | Symlinks regenerados para .agent/ (adaptadores de IDE) |
Se você editou um arquivo gerenciado em .agent/ à mão, o próximo sync
sobrescreve com a versão enviada. Customizações duradouras vão em .agent/custom/.
Quando o sync roda (e quando não)
| Evento | Sync? |
|---|---|
| Abrir ou trocar pasta do workspace | Sim, se kit ausente ou desatualizado |
| Sincronizar kit na barra lateral | Sim |
| Update do app deixou kit obsoleto | Sim |
| Assistente desconecta da prévia | Não |
| Navegar slides ou fechar aba | Não |
Último registro de sync: .open-slide/kit-sync.json na raiz do workspace.
Regra prática: carrosséis em slides/, texto-fonte em repository/ e temas pessoais
em themes/custom/ — trate como permanente. Rode sync do kit quando o Casper pedir; suas
pastas próprias permanecem intactas.
Acompanhamento de produção
Estágios de aprovação (rascunho, em revisão, pronto, publicado) ficam em
slides/.production-board.json — veja Produção. Os arquivos de
tela do carrossel não mudam; o quadro é sua camada de fluxo.
Catálogo do projeto (project.json)
Na raiz do workspace, project.json lista decks para o catálogo do app —
títulos, pastas e ordem. Seu assistente mantém ao criar decks com /create-slide.
Normalmente você não edita à mão.
| Arquivo | Finalidade |
|---|---|
project.json | Catálogo de decks — títulos, pastas, ordem |
slides/.production-board.json | Estágios kanban e metadados de publicação |
slides/.folders.json | Nomes e ícones de pastas na barra lateral |
O sync nunca sobrescreve project.json. Se uma pasta existe em slides/ mas falta no
catálogo, o Casper pode mostrar aviso de órfão — veja Solução de problemas.