codus
← All documentation

What comes back when I reopen Codus?

Codus restores your saved workspace and can resume the selected provider's saved conversation. This is not limited to Claude. Local servers, browsers, workers and other running processes are a separate matter: restoring conversation history does not mean those services are running again.

Before you start

Keep the same project folder and provider selected. Resuming depends on a usable saved session and an available provider. Do not delete local session data or create a new project merely because you see a plain terminal.

When you reopen

  1. Open the workspace tab you need. Some terminals resume when their tab becomes active.
  2. Check the project folder and selected provider.
  3. If the agent resumes, read its message about what needs restarting.
  4. Approve only the specific servers or workers you intend to restart. The resume prompt asks the agent to check first, not silently boot everything.

A previously stopped or never-started agent need not resume automatically. Switching back to a tab is not a reliable way to restart an agent you deliberately exited.

If only a plain terminal appears

Use start unbooted for the intended provider to start or continue its available conversation without requesting a full project boot. If the session cannot be found, retain the error and ask for help before deleting anything.

boot project requests the project's startup workflow. It is not a general “recover my missing history” button and should not be described as automatically wiping every provider's conversation.

Switching to a different provider is also separate from resuming the existing one. Use provider switching guidance and wait for its result.

How do I know it worked?

The intended provider opens the expected conversation for the correct folder. Then verify any authorised server restart separately: a readable conversation is not proof that a preview, queue or background job is alive.

Read as markdownUpdated 2026-09-09