Organize Codex sessions by project (not profile)
CodexUse v2 does not separate chats by profile. It groups sessions by project and adds search, favorites, and pinning.
Key takeaway: Pick a project, then use search + favorites + pinning to find sessions fast.
How sessions are grouped
Sessions are grouped by your working directory (project). Select a project and you’ll see only the sessions from that workspace.
Search, favorites, pinning
- Search filters session titles and previews.
- Favorites keep important sessions one click away.
- Pinning keeps important sessions and projects easy to reach.
Rename and delete sessions
Use the session row actions to rename, pin, or delete sessions you no longer need.
What about profiles?
Profiles manage OpenAI auth and config isolation. They do not split chat history in CodexUse v2.
Best practices
- Run Codex from consistent project roots.
- Rename important sessions early.
- Favorite sessions you revisit often.
Troubleshooting
| Symptom | Likely cause | Action |
|---|---|---|
| No sessions listed | No project selected | Select a project to view sessions. |
| Cannot find a session | Search or filters don’t match | Clear filters and try a broader search. |
| Session resume fails | Profile credentials expired | Re-authenticate the profile, then retry. |
Related
Does the Codex CLI save chat history?
Yes, locally. But it does not organize by account. CodexUse v2 organizes sessions by project instead.
Does CodexUse separate chats by profile?
No. CodexUse v2 uses project grouping, search, favorites, and pinning.
Can I search through old Codex conversations?
Yes. Use the session search box plus favorites and pinning.