codexapi 0.1.1__tar.gz → 0.1.2__tar.gz

{codexapi-0.1.1/src/codexapi.egg-info → codexapi-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: codexapi
-Version: 0.1.1
+Version: 0.1.2
 Summary: Minimal Python API for running the Codex CLI.
 License: MIT
 Keywords: codex,agent,cli,openai
@@ -37,11 +37,16 @@ print(agent("Say hello"))
 session = Agent(cwd="/path/to/project")
 print(session("Summarize this repo."))
 print(session("Now list any risks."))
+
+# Save and resume a session later
+thread_id = session.thread_id
+session2 = Agent(cwd="/path/to/project", trace_id=thread_id)
+print(session2("Continue from where we left off."))
 ```
 
 ## API
 
-### `agent(prompt, cwd=None, *, yolo=False, agent="codex") -> str`
+### `agent(prompt, cwd=None, *, yolo=False, agent="codex", flags=None) -> str`
 
 Runs a single Codex turn and returns only the agent's message. Any reasoning
 items are filtered out.
@@ -50,8 +55,9 @@ items are filtered out.
 - `cwd` (str | PathLike | None): working directory for the Codex session.
 - `yolo` (bool): pass `--yolo` to Codex when true.
 - `agent` (str): agent backend to use (only `"codex"` is supported).
+- `flags` (str | None): extra CLI flags to pass to Codex.
 
-### `Agent(cwd=None, *, yolo=False, agent="codex", trace_id=None)`
+### `Agent(cwd=None, *, yolo=False, agent="codex", trace_id=None, flags=None)`
 
 Creates a stateful session wrapper. Calling the instance sends the prompt into
 the same conversation and returns only the agent's message.
@@ -61,6 +67,7 @@ the same conversation and returns only the agent's message.
 - `trace_id` (str | None): Codex thread id to resume from the first call.
 - `yolo` (bool): pass `--yolo` to Codex when true.
 - `agent` (str): agent backend to use (only `"codex"` is supported).
+- `flags` (str | None): extra CLI flags to pass to Codex.
 
 ## Behavior notes
 

{codexapi-0.1.1 → codexapi-0.1.2}/README.md

@@ -25,11 +25,16 @@ print(agent("Say hello"))
 session = Agent(cwd="/path/to/project")
 print(session("Summarize this repo."))
 print(session("Now list any risks."))
+
+# Save and resume a session later
+thread_id = session.thread_id
+session2 = Agent(cwd="/path/to/project", trace_id=thread_id)
+print(session2("Continue from where we left off."))
 ```
 
 ## API
 
-### `agent(prompt, cwd=None, *, yolo=False, agent="codex") -> str`
+### `agent(prompt, cwd=None, *, yolo=False, agent="codex", flags=None) -> str`
 
 Runs a single Codex turn and returns only the agent's message. Any reasoning
 items are filtered out.
@@ -38,8 +43,9 @@ items are filtered out.
 - `cwd` (str | PathLike | None): working directory for the Codex session.
 - `yolo` (bool): pass `--yolo` to Codex when true.
 - `agent` (str): agent backend to use (only `"codex"` is supported).
+- `flags` (str | None): extra CLI flags to pass to Codex.
 
-### `Agent(cwd=None, *, yolo=False, agent="codex", trace_id=None)`
+### `Agent(cwd=None, *, yolo=False, agent="codex", trace_id=None, flags=None)`
 
 Creates a stateful session wrapper. Calling the instance sends the prompt into
 the same conversation and returns only the agent's message.
@@ -49,6 +55,7 @@ the same conversation and returns only the agent's message.
 - `trace_id` (str | None): Codex thread id to resume from the first call.
 - `yolo` (bool): pass `--yolo` to Codex when true.
 - `agent` (str): agent backend to use (only `"codex"` is supported).
+- `flags` (str | None): extra CLI flags to pass to Codex.
 
 ## Behavior notes
 

{codexapi-0.1.1 → codexapi-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "codexapi"
-version = "0.1.1"
+version = "0.1.2"
 description = "Minimal Python API for running the Codex CLI."
 readme = "README.md"
 requires-python = ">=3.8"

{codexapi-0.1.1 → codexapi-0.1.2}/src/codexapi/__init__.py

@@ -3,4 +3,4 @@
 from .client import Agent, agent
 
 __all__ = ["Agent", "agent"]
-__version__ = "0.1.1"
+__version__ = "0.1.2"

{codexapi-0.1.1 → codexapi-0.1.2}/src/codexapi/client.py

@@ -4,6 +4,7 @@ from __future__ import annotations
 
 import json
 import os
+import shlex
 import subprocess
 from typing import Optional, Tuple, Union
 
@@ -18,6 +19,7 @@ def agent(
     *,
     yolo: bool = False,
     agent: str = "codex",
+    flags: Optional[str] = None,
 ) -> str:
     """Run a single Codex turn and return only the agent's message.
 
@@ -26,6 +28,7 @@ def agent(
         cwd: Optional working directory for the Codex session.
         yolo: Whether to pass --yolo to Codex.
         agent: Agent backend to use (only "codex" is supported).
+        flags: Additional raw CLI flags to pass to Codex.
 
     Returns:
         The agent's visible response text with reasoning traces removed.
@@ -36,6 +39,7 @@ def agent(
         cwd=cwd,
         thread_id=None,
         yolo=yolo,
+        flags=flags,
     )
     return message
 
@@ -56,6 +60,7 @@ class Agent:
         yolo: bool = False,
         agent: str = "codex",
         trace_id: Optional[str] = None,
+        flags: Optional[str] = None,
     ) -> None:
         """Create a new session wrapper.
 
@@ -64,10 +69,12 @@ class Agent:
             yolo: Whether to pass --yolo to Codex.
             agent: Agent backend to use (only "codex" is supported).
             trace_id: Optional Codex thread id to resume from the first call.
+            flags: Additional raw CLI flags to pass to Codex.
         """
         _require_codex_agent(agent)
         self._cwd = cwd
         self._yolo = yolo
+        self._flags = flags
         self._thread_id: Optional[str] = trace_id
 
     def __call__(self, prompt: str) -> str:
@@ -77,6 +84,7 @@ class Agent:
             cwd=self._cwd,
             thread_id=self._thread_id,
             yolo=self._yolo,
+            flags=self._flags,
         )
         if thread_id:
             self._thread_id = thread_id
@@ -94,6 +102,7 @@ def _run_codex(
     cwd: Optional[Pathish],
     thread_id: Optional[str],
     yolo: bool,
+    flags: Optional[str],
 ) -> Tuple[str, Optional[str]]:
     """Invoke the Codex CLI and return the message plus thread id (if any)."""
     cmd = [
@@ -106,6 +115,8 @@ def _run_codex(
     ]
     if yolo:
         cmd.append("--yolo")
+    if flags:
+        cmd.extend(shlex.split(flags))
     if cwd is not None:
         cmd.extend(["--cd", os.fspath(cwd)])
     if thread_id:

{codexapi-0.1.1 → codexapi-0.1.2/src/codexapi.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: codexapi
-Version: 0.1.1
+Version: 0.1.2
 Summary: Minimal Python API for running the Codex CLI.
 License: MIT
 Keywords: codex,agent,cli,openai
@@ -37,11 +37,16 @@ print(agent("Say hello"))
 session = Agent(cwd="/path/to/project")
 print(session("Summarize this repo."))
 print(session("Now list any risks."))
+
+# Save and resume a session later
+thread_id = session.thread_id
+session2 = Agent(cwd="/path/to/project", trace_id=thread_id)
+print(session2("Continue from where we left off."))
 ```
 
 ## API
 
-### `agent(prompt, cwd=None, *, yolo=False, agent="codex") -> str`
+### `agent(prompt, cwd=None, *, yolo=False, agent="codex", flags=None) -> str`
 
 Runs a single Codex turn and returns only the agent's message. Any reasoning
 items are filtered out.
@@ -50,8 +55,9 @@ items are filtered out.
 - `cwd` (str | PathLike | None): working directory for the Codex session.
 - `yolo` (bool): pass `--yolo` to Codex when true.
 - `agent` (str): agent backend to use (only `"codex"` is supported).
+- `flags` (str | None): extra CLI flags to pass to Codex.
 
-### `Agent(cwd=None, *, yolo=False, agent="codex", trace_id=None)`
+### `Agent(cwd=None, *, yolo=False, agent="codex", trace_id=None, flags=None)`
 
 Creates a stateful session wrapper. Calling the instance sends the prompt into
 the same conversation and returns only the agent's message.
@@ -61,6 +67,7 @@ the same conversation and returns only the agent's message.
 - `trace_id` (str | None): Codex thread id to resume from the first call.
 - `yolo` (bool): pass `--yolo` to Codex when true.
 - `agent` (str): agent backend to use (only `"codex"` is supported).
+- `flags` (str | None): extra CLI flags to pass to Codex.
 
 ## Behavior notes