Codex
Auto-save your Codex sessions
Work done in the OpenAI Codex CLI is hard to revisit once the session is closed. Setting up the SHISHO CLI writes Codex's notify hook and MCP configuration for you, so session logs are sent to SHISHO. Saved sessions are summarized by AI and can be searched and reused.
What gets saved to SHISHO
- Your instructions and Codex's responses (the full conversation log)
- History of commands and edits Codex performed
- An AI-written session summary
- Session date and working directory
Setup steps
Run in your terminal:
$ npx shisho setup
- 1
In a terminal with Node.js 18 or later, run the command below.
- 2
A browser window opens — sign in with your SHISHO account to finish setup.
- 3
Done. The MCP connection and notify hook are added to Codex's config.toml and sessions are saved to SHISHO automatically.
- 4
Open the Sessions page in SHISHO to search and browse saved sessions.
Frequently asked questions
- Where are Codex session logs stored?
- Codex CLI stores session JSONL files under ~/.codex/sessions/. The SHISHO CLI reads and sends them.
- Can I search SHISHO from inside a Codex chat?
- Yes. Setup registers SHISHO as an MCP server, so you can search and reference past notes and sessions during a Codex conversation.
- How often does it sync?
- On the notify hook at session end, plus a 30-minute periodic sync on Plus and Pro plans.
Start for free
Creating an account takes a minute. Saving and searching conversations works on the Free plan.
Start SHISHO for free