Start a new conversation with OpenAI Codex CLI.

Runs codex CLI in read-only sandbox mode and returns a thread_id for continuing the conversation later.

Limitations:

• Runs in read-only sandbox — cannot modify files or execute shell commands.

• Use only for read-only tasks: code reading, analysis, and Q&A.

When to use:

1. Analyzing the structure or behavior of a codebase

2. Code review or root cause analysis of bugs

3. Generating explanations or documentation drafts for code

4. Getting refactoring or architecture suggestions

Args: prompt: Prompt to send to codex. Use @filepath to mention files. working_directory: Directory path for codex to work in (optional).

Returns: Dict with thread_id and response.

Continue an existing Codex conversation.

Resumes a previous conversation using thread_id to maintain context. Same read-only sandbox limitations as start_new_conversation apply.

When to use:

1. Asking follow-up questions based on previous analysis

2. Continuing multi-step analysis on the same codebase

3. Sending additional requests while maintaining conversation context

Args: thread_id: thread_id from a previous conversation. prompt: Follow-up prompt to send to codex. Use @filepath to mention files. working_directory: Directory path for codex to work in (optional).

Returns: Dict with thread_id and response.