Cmd. /new
Start a new conversation inside the current CLI session.
Key takeaways
- Start a new conversation inside the current CLI session.
- Check the input surface and availability before using the examples below.
Purpose
Start a new conversation inside the current CLI session.
/new [name]Availability
| 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
/new parser-migrationWhen to use it
- Use
/newwhen switching to an unrelated task in the same repository. - Use
/planimmediately after/newwhen the new task has risk or ambiguity.
Choosing related commands
| Command | Difference | Choose It When |
|---|---|---|
/new | Starts a fresh conversation | You want a clean prompt in the same CLI |
/clear | Clears the terminal and starts fresh | You also want the visible UI reset |
/quit | Exits the CLI | You are done with the terminal session |
Effects and persistence
Starts a fresh conversation. Restate instructions that depended on the previous conversation when needed.
/new [name] resets chat context inside the same CLI session and optionally persists a thread name.
Cautions
- Save important details before starting a new conversation.
/newdoes not replace Git hygiene; review changes before changing tasks.
Official sources
Complete command list · Verification scope · History for this command