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 Nokos CLI writes Codex's notify hook and MCP configuration for you, so session logs are sent to Nokos. Saved sessions are summarized by AI and can be searched and reused.

What gets saved to Nokos

  • 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 nokos setup
  1. 1

    In a terminal with Node.js 18 or later, run the command below.

  2. 2

    A browser window opens — sign in with your Nokos account to finish setup.

  3. 3

    Done. The MCP connection and notify hook are added to Codex's config.toml and sessions are saved to Nokos automatically.

  4. 4

    Open the Sessions page in Nokos 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 Nokos CLI reads and sends them.
Can I search Nokos from inside a Codex chat?
Yes. Setup registers Nokos 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 Nokos for free