Threads

A thread is the unit of persisted conversation in Codex. The TypeScript SDK exposes startThread, resumeThread, and run; the MCP server exposes the equivalent thread/start, thread/resume, thread/fork, thread/read, and thread/list methods.

Copyconst thread = codex.startThread({ workingDirectory: "/path/to/repo" });
const turn = await thread.run("Inspect the repository and explain its architecture");

Threads are persisted in ~/.codex/sessions. Use resumeThread(threadId) to continue a saved conversation, or thread/fork when a new conversation should start from existing context. A thread normally runs in a Git repository; skipGitRepoCheck is available when the host intentionally permits another working directory.

See the TypeScript SDK and MCP server references for examples.