Skip to main content
Handshake reads:
  • ~/.codex/session_index.jsonl
  • ~/.codex/sessions/YYYY/MM/DD/
Set CODEX_HOME before setup when Codex uses another directory.

​
Installed integration

handshake setup can install:
  • An MCP entry in ~/.codex/config.toml.
  • PreCompact, PostCompact, and Stop hook scripts in ~/.codex/hooks/.
  • Hook registration in ~/.codex/hooks.json.
  • Managed Handshake skills.
Handshake also imports Codex sessions before list_sessions returns its result. A failed import appears as a synchronization warning.

​
Connect Codex

1

Run setup

Run:
2

Trust the hooks

Open Codex. Run /hooks and trust the Handshake hook scripts.
3

Verify the connection

Enter:
The ChatGPT desktop app, Codex CLI, and Codex IDE integration use the same Codex configuration directory. Import Codex sessions directly with: