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
| Sistema | Caminho |
|---|---|
| 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
| Item | O que é |
|---|---|
deck-state.json | O 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.json | Tamanho 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.json | As 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 registros | Os 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-deckRestaurar é 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
- Feche o Deck.
- Renomeie a pasta de dados, em vez de apagar, até ter certeza de que não vai precisar dela.
- 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.