Feature: Multi-Session Management for Codex CLI

[kshitizz36]

Feature: Multi-Session Management for Codex CLI

What?

Implement the ability to save, name, list, and switch between multiple Codex sessions (rollouts) from the CLI. This will make it easy for users to work on multiple projects or tasks concurrently and revisit previous sessions.

Why?

• Many users work on several projects or features at once.
• Quick context switching boosts productivity.
• Useful for demos, debugging, or reviewing past work.

How?

• Add new CLI subcommands: codex session list|save|load|delete.
• Store sessions with metadata: name, timestamp, last activity.
• Integrate with existing rollout/session logic.
• Add tests and update documentation.

Example Usage

codex session save my-new-feature
codex session list
codex session load bugfix-123
codex session delete old-session

---

[scottleibrand]

It would also be useful to include a new /session command in interactive mode that allows saving the current session/rollout.

[kshitizz36]

This is a great idea. a /session command in interactive mode, so you’ll be able to save, load, list, and delete sessions without leaving your chat.

[scottleibrand]

#118 and #146 are also asking for this, and the latter has a useful (to me) pointer to ~/.codex/sessions/rollout-*.json where sessions are already logged. Seems like the MVP here is session loading, either from the CLI or via a /session command.

[kshitizz36]

Thanks for the helpful insights! I totally agree—the MVP here is session loading, whether from the CLI or via a /session command in interactive mode, since all the necessary files are already logged in ~/.codex/sessions/rollout-*.json.

I plan to work on this once my current pending PR is merged. If anyone else wants to take a crack at these features (session loading or related session management commands), feel free to jump in—just don’t forget to give me a little credit for the idea and groundwork! 😊

[jazzyalex]

That would be a great addition and partially implemented. Right now, Codex CLI already stores all rollouts in
~/.codex/sessions/YYYY/MM/DD/, but there’s no native way to name, list ALL of them, or easily search in all sessions — everything depends on manual JSONL lookup and /resume .

I’ve been exploring this same idea externally through Agent Sessions — an open-source macOS app that reads those rollout logs locally and lets you visually browse, search, and resume sessions (plus track usage limits).
A native CLI version of that workflow would fit perfectly into Codex’s roadmap.

[lulu-sk]

If you are using Windows 11, you can try out my open-source project.
Hey everyone! 👋
I'm excited to share a project I've been working on: CodexFlow — a unified, graphical workspace built on top of the Codex CLI!

It’s designed to make your workflow smoother, faster, and more organized, especially on Windows + WSL2.

💡 What it does

CodexFlow lets you:

• 📂 Organize sessions by project, automatically
• 🧠 Resume past conversations (even legacy ones!)
• 🖼️ Paste images, drag files, or @mention project assets in your prompt
• 🔍 Search, preview, and copy from past runs instantly
• 🧵 Work with multiple tabs per project
• ⚡ Stay in flow without messing with CLI history files

Just open CodexFlow → pick a project → start prompting.
It feels like using a modern IDE for Codex.

🖼️ Interface Sneak Peek

Pasted image inline preview

Resume historical sessions

History search & preview

Rich input (paste images / drag files / @file)

🛠️ Best platform setup

Windows 11 + WSL2 (default Ubuntu 24.04).
PowerShell mode also works (experimental).

👉 Try it now:

GitHub: https://github.com/lulu-sk/CodexFlow
Would love your feedback, suggestions, or contributions!

[shrimpwagon]

Probably not quite what you are looking for but I came up with this Codex project session manager script. Way better than what the CLI comes with imo. I use it all the time now!

GitHub Gist: codex project session manager - codex-run.sh

[jazzyalex]

nice small tool - if you need something more advanced (yet very intuitive and visual) and on macOS - try my Agent Sessions — an open-source macOS app that reads those rollout logs locally and lets you visually browse, search, and resume sessions (plus track usage limits).

[AtomicRaven]

I'll add on top of this- connect Codex with ChatGPT projects - manage from there if need be.