Struct Codex 

pub struct Codex { /* private fields */ }

Codex CLI stores one JSONL rollout per session under ~/.codex/sessions/YYYY/MM/DD/rollout-<ts>-<uuid>.jsonl. Lines carry a type plus a payload; the schema has shifted across versions, so both response_item and event_msg shapes are handled.

Codex::default() reads the stock ~/.codex install. An embedder that runs several Codex installs in different homes builds one adapter per install with Codex::in_home.

Implementations

impl Codex

pub fn in_home(home: impl Into<PathBuf>) -> Self

An adapter for the Codex install rooted at home (e.g. ~/.codex2). The sessions sub-directory layout is the adapter’s business, not the caller’s.

Trait Implementations

impl Adapter for Codex

fn reconcile_scope(&self) -> Option<String>

An explicit install speaks only for the rows under its own root; the stock adapter speaks for every Codex row, as before.

fn name(&self) -> &'static str

fn root(&self) -> Option<PathBuf>

Store root, e.g. ~/.claude/projects. May not exist on this machine.

fn discover(&self) -> Discovered

All session files under the root, with a partial-walk flag the indexer uses to protect deletion reconciliation (see Discovered).

fn parse(&self, path: &Path) -> Result<Session>

Parse one session file. Must never panic on malformed input; skip bad lines and return what could be read.

fn store(&self) -> Option<Store>

A shared store (many sessions in one database) for tools that do not use one file per session. When Some, the indexer uses it instead of discover/parse. Default None = ordinary file-per-session adapter.

fn parse_key(&self, _key: &str) -> Result<Session>

Parse one session out of a shared store by its key (from store().keys). Only called for adapters that return a Store.

impl Default for Codex

fn default() -> Codex

Returns the “default value” for a type.