Cmd. /new
Start a new conversation inside the current CLI session.
Key takeaways
/new [name]resets chat context inside the same CLI session and, since 0.146.0, can name the new thread immediately.- Use it when switching to an unrelated task in the same repository, then run
/planif the new task has risk or ambiguity. - Unlike
/clear, which also resets the visible UI,/newgives a clean prompt while staying in the CLI;/quitexits entirely. - Save important details first, since
/newdoes not replace Git hygiene; review changes before changing tasks.
Original Command Declaration
/new [name]Official Summary
/new [name] resets chat context inside the same CLI session and optionally persists a thread name.
Usage
/new [name]Good Examples
- Use
/newwhen switching to an unrelated task in the same repository. - Use
/planimmediately after/newwhen the new task has risk or ambiguity.
Similar 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 |
Use Cases
- Switching tasks without restarting Codex.
- Starting a clean request after a long or noisy conversation.
- Separating unrelated work inside one terminal.
Cautions
- Save important details before starting a new conversation.
/newdoes not replace Git hygiene; review changes before changing tasks.
Release Basis
-
0.146.0 added the optional name argument.
-
Judgment: first observed mention
-
First evidence version:
rust-v0.59.0 -
Date (UTC): 2025-11-19
-
Release link: https://github.com/openai/codex/releases/tag/rust-v0.59.0
Sources
- Codex slash commands: https://developers.openai.com/codex/cli/slash-commands
- Codex CLI features: https://developers.openai.com/codex/cli/features