Pular para o conteúdo
DocumentaçãoInstalar

Referência

Onde ficam os arquivos

Tudo que o Deck guarda fica em uma pasta só, no seu computador. Saber o caminho ajuda a fazer backup, a resolver problema e a ir embora sem deixar rastro.

A pasta de dados

SistemaCaminho
macOS~/Library/Application Support/Deck
Windows%APPDATA%\Deck

Essa pasta é só do Deck. Apagá-la devolve o app ao estado de recém-instalado, sem tocar nos seus repositórios.

O que tem dentro

ItemO que é
deck-state.jsonO estado do app: projetos, contextos, sessões, layout dos painéis e preferências.
backups/Cópia diária do estado, para o caso de o arquivo principal se perder.
window-state.jsonTamanho e posição da janela.
prompts/Os prompts que você salvou para reusar.
goals/Os objetivos escritos por projeto.
themes/Temas seus, além dos que já vêm no app.
rascunhos-editor/O que você digitou no editor embutido e ainda não salvou.
github/Preferências, cache e áreas de revisão de pull request.
deck-tarefas.jsonAs tarefas trazidas do ClickUp e do GitHub.
segredos.json e conta/Tokens das conexões e a credencial da conta, cifrados pelo cofre do sistema.
worktrees/As pastas de trabalho isolado, quando você escolhe guardá-las aqui.
Scripts e registrosOs scripts de aviso dos agentes e os registros do serviço que segura as sessões.

Os arquivos com segredo são cifrados pelo Keychain do macOS ou pelo DPAPI do Windows. Copiar esses arquivos para outra máquina não leva o token junto: ele não abre fora do computador que o cifrou.

O que o app lê fora dali

Para montar a linha de status e saber quando o agente pede permissão, o Deck lê o que os próprios agentes já gravam na sua pasta pessoal:

  • O histórico das conversas e o arquivo de configuração do Claude Code, em ~/.claude.
  • Os registros de sessão do Codex, em ~/.codex.

O Deck também escreve no arquivo de configuração do Claude Code para registrar os avisos e a linha de status, guardando uma cópia do estado anterior ao lado. Isso se desfaz em Configurações, e está explicado em Agentes.

Worktrees

As pastas de trabalho isolado não precisam ficar na pasta de dados. Em Configurações você escolhe entre guardá-las ali, ao lado do repositório, dentro dele ou em um caminho seu. Seja qual for a escolha, são pastas git normais: apagar o Deck não apaga nenhuma delas.

O detalhe de como elas nascem e como se removem está em Tarefas isoladas.

Backup

Para guardar a organização do seu Deck, basta copiar a pasta de dados com o app fechado. O que importa está no estado e nas pastas de prompts, objetivos e temas.

# macOS
cp -R ~/Library/Application\ Support/Deck ~/Desktop/backup-deck

Restaurar é o caminho inverso, também com o app fechado. Credencial e tokens não atravessam para outra máquina, então lá você entra de novo e reconecta.

Começar do zero

  1. Feche o Deck.
  2. Renomeie a pasta de dados, em vez de apagar, até ter certeza de que não vai precisar dela.
  3. Abra o app de novo. Ele nasce limpo, pedindo login.

No macOS, sessões que estavam no tmux do Deck continuam de pé mesmo depois disso, porque não vivem nessa pasta. Se a ideia é zerar de verdade, encerre as sessões antes.