Cmd. /archive
Archive a completed or abandoned Codex session.
Key takeaways
- Archive a completed or abandoned Codex session.
- Check the input surface and availability before using the examples below.
Purpose
Archive a completed or abandoned Codex session.
/archiveAvailability
| Field | Value |
|---|---|
| Input surface | Running CLI prompt |
| Kind | Built-in |
| Status | Current reference |
| Aliases | — |
| Documented minimum | Not specified |
| Reviewed against | 2026-09-22 · Codex CLI 0.155.1 |
The installed command menu and account or organization settings determine availability.
Examples
/archiveThe related CLI subcommands are:
codex archive
codex unarchiveWhen to use it
- Archive completed research so
/resumestays focused on active work. - Before archiving an abandoned experiment, leave a final note explaining why it was abandoned.
- After unarchiving an old session, run
/status,/goal, and/diffbefore continuing.
Choosing related commands
| Command | Difference | Choose It When |
|---|---|---|
/archive | Moves a session out of active resume/fork flows | You are done with a session but want to keep it recoverable |
/resume | Reopens saved conversation history | You need to continue earlier work |
/fork | Branches a conversation | You want an alternate path |
/new | Starts a fresh conversation | You want a clean task |
Effects and persistence
Archives the session; choose it separately from permanent deletion.
/archive is an official slash command for archiving a Codex session. Archived sessions are
protected from resume/fork until restored, and app clients can expose archived chats or threads from
their archived area.
Changes
- The TUI can archive sessions with
/archive. - The CLI includes
codex archiveandcodex unarchive. - Archived sessions are protected from resume/fork until restored.
- App-server thread events include
thread/archivedandthread/unarchived.
Cautions
- As of the June 12, 2026 check,
/archiveis listed in the official slash-command table. - Do not archive a session with pending approval or input unless the blocker and next decision are documented.
- Archive is not deletion; follow separate retention rules for sensitive transcripts.
Official sources
Complete command list · Verification scope · History for this command