---
id: "terminal-retomar-sessoes"
titulo: "Retomar depois de reiniciar"
resumo: "O que volta quando você fecha e reabre o app: arranjo das abas, painéis e histórico — e por que o processo anterior não volta."
idioma: "pt-br"
tipo: "conceito"
categoria: "telas"
aplicavelDesde: "0.0.16"
capabilities: ["terminal.sessions.restore"]
estadoEditorial: "aprovado"
nivelEvidencia: "artefato-distribuido"
refFonte: "27574c339b58316408f6be2d62169d59041d07bf"
revisaoFonte: "2026-09-24"
revisor: "mantenedor (v1, 2026-10-03)"
rota: "/docs/pt-br/ferramentas/terminal/retomar-sessoes/"
fonte: "pt-br/ferramentas/terminal/retomar-sessoes.md"
caminhoPublico: "docs/publica/pt-br/ferramentas/terminal/retomar-sessoes.md"
hashFonte: "sha256:7a264a0d13cc44b3404c5b673c2fb6cc0f4a16c84a44babd2e05ef178eb2c757"
hashDestaPagina: "sha256:7a264a0d13cc44b3404c5b673c2fb6cc0f4a16c84a44babd2e05ef178eb2c757"
traducaoAssistidaPorIA: false
traducaoDesatualizada: false
corpoRetido: false
---
A tela Terminal é restaurada, não ressuscitada. Essa distinção explica tudo o que você vê ao reabrir o app.

## O que volta

- **O arranjo:** abas, painéis, divisões, tamanhos e títulos.
- **O histórico:** o conteúdo retido é redesenhado no painel.
- **O aviso de restauração:** o painel restaurado recebe uma faixa com o texto `--- session restored ---`, para você não confundir o histórico redesenhado com saída nova.

## O que não volta

- **O processo.** A sessão anterior morreu com o app. O que você tem é uma sessão nova, com o histórico desenhado por cima. Um comando em andamento não continua; um servidor de desenvolvimento que rodava ali não sobe sozinho.

É por isso que a faixa de restauração existe: sem ela, um histórico redesenhado pareceria um processo vivo.

## O teto do histórico

O histórico guardado para restauração é **limitado por bytes**, em três camadas: o que cada sessão pode guardar, o que é reproduzido de volta e o total do armazenamento. Quando o volume passa do limite, **o mais antigo é cortado**.

Consequências práticas:

- Saída muito longa não volta inteira — o começo é o primeiro a sumir.
- Sessões que escrevem muito (builds verbosos, logs contínuos) perdem o início mais rápido.
- O corte por workspace significa que uma sessão barulhenta pode afetar o que sobra para as outras.

## Quando a gravação do estado falha

Se o estado da sessão não puder ser gravado, o app **avisa com um diálogo próprio** — não com um erro genérico. Falha de gravação significa que aquele painel não terá restauração: a sessão nova nasce sem o histórico anterior.

O diálogo de falha oferece o caminho para o analisador de espaço em disco, porque a causa comum é espaço ou volume de dados.

## Abas que saem da área visível

Abas fora de vista entram em **repouso** e são reidratadas quando você volta a elas. Isso reduz o custo de manter muitas abas abertas sem fechar nada — mas vale a mesma regra: ao voltar, você encontra o histórico retido, não o processo.

## Replay: o que pode dar errado

A reprodução do histórico é guardada por uma política que evita despejar no histórico a tela de uma execução já morta. Quando essa proteção não cobre o caso, o efeito visível é histórico antigo aparecendo no meio da saída atual — se você vir isso, é histórico reproduzido, não saída do processo.

## Se a restauração não é o que você quer

- **Quer continuar de onde parou num processo?** Não há caminho: a sessão anterior não volta. Recrie a sessão e siga do estado que está em disco.
- **O painel não abre de jeito nenhum?** Veja [Quando o terminal não abre](/docs/pt-br/ferramentas/terminal/quando-nao-abre/).