Cmd. /delete
Permanently delete the current Codex session transcript and spawned descendant sessions.
Key takeaways
- Permanently delete the current Codex session transcript and spawned descendant sessions.
- Check the input surface and availability before using the examples below.
Purpose
Permanently delete the current Codex session transcript and spawned descendant sessions.
/deleteAvailability
| 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
/deleteWhen to use it
- Delete a temporary test session that included sensitive prompt material.
- Remove an abandoned experiment and its spawned descendant sessions.
- Before deleting an audit-relevant session, capture required evidence in a ticket, PR, or export.
Choosing related commands
| Command | Difference | Choose It When |
|---|---|---|
/delete | Permanently removes the transcript | The record should not be retained |
/archive | Keeps the transcript recoverable | You only want to clean the active list |
/quit | Exits without changing retention | You want to leave the session intact |
Effects and persistence
Opens the permanent session-deletion flow. Use archive when you only want to put the session aside.
/delete is an official slash command for permanently deleting the current Codex session
transcript and exiting the TUI. Use it for sensitive or disposable sessions where archiving is not
enough.
Changes
/deletewas added to the official slash command table.- The related
codex delete <SESSION>CLI path and app-serverthread/deletepath were added. - Deletion removes the current session and spawned descendant sessions.
Cautions
- Deletion is permanent; check retention, audit, and incident-response needs first.
/deleteis unavailable while a task is running or inside a side conversation.- If you only want to clean the resume list, use
/archive.
Official sources
Complete command list · Verification scope · History for this command