codexapi 0.3.3__tar.gz → 0.4.0__tar.gz

{codexapi-0.3.3/src/codexapi.egg-info → codexapi-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: codexapi
-Version: 0.3.3
+Version: 0.4.0
 Summary: Minimal Python API for running the Codex CLI.
 License: MIT
 Keywords: codex,agent,cli,openai
@@ -85,6 +85,8 @@ Resume a session and print the thread id to stderr:
 codexapi run --thread-id THREAD_ID --print-thread-id "Continue where we left off."
 ```
 
+Use `--no-yolo` to run Codex with `--full-auto` instead.
+
 Ralph loop mode repeats the same prompt until a completion promise or a max
 iteration cap is hit (0 means unlimited). Cancel by deleting
 `.codexapi/ralph-loop.local.md` or running `codexapi ralph --cancel`.
@@ -97,27 +99,27 @@ codexapi ralph --cancel --cwd /path/to/project
 
 ## API
 
-### `agent(prompt, cwd=None, yolo=False, flags=None) -> str`
+### `agent(prompt, cwd=None, yolo=True, flags=None) -> str`
 
 Runs a single Codex turn and returns only the agent's message. Any reasoning
 items are filtered out.
 
 - `prompt` (str): prompt to send to Codex.
 - `cwd` (str | PathLike | None): working directory for the Codex session.
-- `yolo` (bool): pass `--yolo` to Codex when true.
+- `yolo` (bool): pass `--yolo` to Codex when true (defaults to true).
 - `flags` (str | None): extra CLI flags to pass to Codex.
 
-### `Agent(cwd=None, yolo=False, thread_id=None, flags=None)`
+### `Agent(cwd=None, yolo=True, thread_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.
 
 - `__call__(prompt) -> str`: send a prompt to Codex and return the message.
 - `thread_id -> str | None`: expose the underlying session id once created.
-- `yolo` (bool): pass `--yolo` to Codex when true.
+- `yolo` (bool): pass `--yolo` to Codex when true (defaults to true).
 - `flags` (str | None): extra CLI flags to pass to Codex.
 
-### `task(prompt, check=None, n=10, cwd=None, yolo=False, flags=None) -> str`
+### `task(prompt, check=None, n=10, cwd=None, yolo=True, flags=None) -> str`
 
 Runs a task with checker-driven retries and returns the success summary.
 Raises `TaskFailed` when the maximum attempts are reached.
@@ -125,12 +127,12 @@ Raises `TaskFailed` when the maximum attempts are reached.
 - `check` (str | None | False): custom check prompt, default checker, or `False` to skip.
 - `n` (int): maximum number of retries after a failed check.
 
-### `task_result(prompt, check=None, n=10, cwd=None, yolo=False, flags=None) -> TaskResult`
+### `task_result(prompt, check=None, n=10, cwd=None, yolo=True, flags=None) -> TaskResult`
 
 Runs a task with checker-driven retries and returns a `TaskResult` without
 raising `TaskFailed`.
 
-### `Task(prompt, max_attempts=10, cwd=None, yolo=False, thread_id=None, flags=None)`
+### `Task(prompt, max_attempts=10, cwd=None, yolo=True, thread_id=None, flags=None)`
 
 Runs a Codex task with checker-driven retries. Subclass it and implement
 `check()` to return an error string when the task is incomplete, or return
@@ -165,8 +167,7 @@ Exception raised by `task()` when retries are exhausted.
 
 - Uses `codex exec --json` and parses JSONL events for `agent_message` items.
 - Automatically passes `--skip-git-repo-check` so it can run outside a git repo.
-- Passes `--full-auto` unless `--yolo` is enabled.
-- Passes `--yolo` when enabled (use with care).
+- Passes `--yolo` by default (use `--no-yolo` or `yolo=False` for `--full-auto`).
 - Raises `RuntimeError` if Codex exits non-zero or returns no agent message.
 
 ## Configuration

{codexapi-0.3.3 → codexapi-0.4.0}/README.md

@@ -73,6 +73,8 @@ Resume a session and print the thread id to stderr:
 codexapi run --thread-id THREAD_ID --print-thread-id "Continue where we left off."
 ```
 
+Use `--no-yolo` to run Codex with `--full-auto` instead.
+
 Ralph loop mode repeats the same prompt until a completion promise or a max
 iteration cap is hit (0 means unlimited). Cancel by deleting
 `.codexapi/ralph-loop.local.md` or running `codexapi ralph --cancel`.
@@ -85,27 +87,27 @@ codexapi ralph --cancel --cwd /path/to/project
 
 ## API
 
-### `agent(prompt, cwd=None, yolo=False, flags=None) -> str`
+### `agent(prompt, cwd=None, yolo=True, flags=None) -> str`
 
 Runs a single Codex turn and returns only the agent's message. Any reasoning
 items are filtered out.
 
 - `prompt` (str): prompt to send to Codex.
 - `cwd` (str | PathLike | None): working directory for the Codex session.
-- `yolo` (bool): pass `--yolo` to Codex when true.
+- `yolo` (bool): pass `--yolo` to Codex when true (defaults to true).
 - `flags` (str | None): extra CLI flags to pass to Codex.
 
-### `Agent(cwd=None, yolo=False, thread_id=None, flags=None)`
+### `Agent(cwd=None, yolo=True, thread_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.
 
 - `__call__(prompt) -> str`: send a prompt to Codex and return the message.
 - `thread_id -> str | None`: expose the underlying session id once created.
-- `yolo` (bool): pass `--yolo` to Codex when true.
+- `yolo` (bool): pass `--yolo` to Codex when true (defaults to true).
 - `flags` (str | None): extra CLI flags to pass to Codex.
 
-### `task(prompt, check=None, n=10, cwd=None, yolo=False, flags=None) -> str`
+### `task(prompt, check=None, n=10, cwd=None, yolo=True, flags=None) -> str`
 
 Runs a task with checker-driven retries and returns the success summary.
 Raises `TaskFailed` when the maximum attempts are reached.
@@ -113,12 +115,12 @@ Raises `TaskFailed` when the maximum attempts are reached.
 - `check` (str | None | False): custom check prompt, default checker, or `False` to skip.
 - `n` (int): maximum number of retries after a failed check.
 
-### `task_result(prompt, check=None, n=10, cwd=None, yolo=False, flags=None) -> TaskResult`
+### `task_result(prompt, check=None, n=10, cwd=None, yolo=True, flags=None) -> TaskResult`
 
 Runs a task with checker-driven retries and returns a `TaskResult` without
 raising `TaskFailed`.
 
-### `Task(prompt, max_attempts=10, cwd=None, yolo=False, thread_id=None, flags=None)`
+### `Task(prompt, max_attempts=10, cwd=None, yolo=True, thread_id=None, flags=None)`
 
 Runs a Codex task with checker-driven retries. Subclass it and implement
 `check()` to return an error string when the task is incomplete, or return
@@ -153,8 +155,7 @@ Exception raised by `task()` when retries are exhausted.
 
 - Uses `codex exec --json` and parses JSONL events for `agent_message` items.
 - Automatically passes `--skip-git-repo-check` so it can run outside a git repo.
-- Passes `--full-auto` unless `--yolo` is enabled.
-- Passes `--yolo` when enabled (use with care).
+- Passes `--yolo` by default (use `--no-yolo` or `yolo=False` for `--full-auto`).
 - Raises `RuntimeError` if Codex exits non-zero or returns no agent message.
 
 ## Configuration

{codexapi-0.3.3 → codexapi-0.4.0}/pyproject.toml

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

{codexapi-0.3.3 → codexapi-0.4.0}/src/codexapi/__init__.py

@@ -12,4 +12,4 @@ __all__ = [
     "task",
     "task_result",
 ]
-__version__ = "0.3.3"
+__version__ = "0.4.0"

{codexapi-0.3.3 → codexapi-0.4.0}/src/codexapi/agent.py

@@ -8,7 +8,7 @@ import subprocess
 _CODEX_BIN = os.environ.get("CODEX_BIN", "codex")
 
 
-def agent(prompt, cwd=None, yolo=False, flags=None):
+def agent(prompt, cwd=None, yolo=True, flags=None):
     """Run a single Codex turn and return only the agent's message.
 
     Args:
@@ -36,7 +36,7 @@ class Agent:
     def __init__(
         self,
         cwd=None,
-        yolo=False,
+        yolo=True,
         thread_id=None,
         flags=None,
     ):

{codexapi-0.3.3 → codexapi-0.4.0}/src/codexapi/cli.py

@@ -908,7 +908,12 @@ def main(argv=None):
         help="Prompt to send. Use '-' or omit to read from stdin.",
     )
     run_parser.add_argument("--cwd", help="Working directory for the Codex session.")
-    run_parser.add_argument("--yolo", action="store_true", help="Pass --yolo to Codex.")
+    run_parser.add_argument(
+        "--no-yolo",
+        action="store_false",
+        dest="yolo",
+        help="Disable --yolo and use --full-auto.",
+    )
     run_parser.add_argument(
         "--flags",
         help="Additional raw CLI flags to pass to Codex (quoted as needed).",
@@ -943,7 +948,12 @@ def main(argv=None):
         help="Max verification retries after a failed check (0 means no retries).",
     )
     task_parser.add_argument("--cwd", help="Working directory for the Codex session.")
-    task_parser.add_argument("--yolo", action="store_true", help="Pass --yolo to Codex.")
+    task_parser.add_argument(
+        "--no-yolo",
+        action="store_false",
+        dest="yolo",
+        help="Disable --yolo and use --full-auto.",
+    )
     task_parser.add_argument(
         "--flags",
         help="Additional raw CLI flags to pass to Codex (quoted as needed).",
@@ -986,7 +996,12 @@ def main(argv=None):
         help="Start each iteration with a fresh Agent context.",
     )
     ralph_parser.add_argument("--cwd", help="Working directory for the Codex session.")
-    ralph_parser.add_argument("--yolo", action="store_true", help="Pass --yolo to Codex.")
+    ralph_parser.add_argument(
+        "--no-yolo",
+        action="store_false",
+        dest="yolo",
+        help="Disable --yolo and use --full-auto.",
+    )
     ralph_parser.add_argument(
         "--flags",
         help="Additional raw CLI flags to pass to Codex (quoted as needed).",

{codexapi-0.3.3 → codexapi-0.4.0}/src/codexapi/ralph.py

@@ -15,7 +15,7 @@ _PROMISE_RE = re.compile(r"<promise>(.*?)</promise>", re.DOTALL)
 def run_ralph_loop(
     prompt,
     cwd=None,
-    yolo=False,
+    yolo=True,
     flags=None,
     max_iterations=0,
     completion_promise=None,
@@ -135,7 +135,7 @@ def run_ralph_loop(
             elif runner is None:
                 runner = Agent(cwd, yolo, None, flags)
 
-            message = runner(prompt)
+            message = runner(prompt + '\nIf there are multiple paths forward, you MUST use your own best judgement as to which to try first! Do not ask the user to choose an option, they hereby give you explciit permission to pick the best one yourself.\n')
             print(message)
             last_message = message
 

{codexapi-0.3.3 → codexapi-0.4.0}/src/codexapi/task.py

@@ -176,7 +176,7 @@ def task(
     check=None,
     n=10,
     cwd=None,
-    yolo=False,
+    yolo=True,
     flags=None,
     progress=False,
 ):
@@ -209,7 +209,7 @@ def task_result(
     check=None,
     n=10,
     cwd=None,
-    yolo=False,
+    yolo=True,
     flags=None,
     progress=False,
 ):
@@ -319,7 +319,7 @@ class Task:
         prompt,
         max_attempts=10,
         cwd=None,
-        yolo=False,
+        yolo=True,
         thread_id=None,
         flags=None,
     ):

{codexapi-0.3.3 → codexapi-0.4.0/src/codexapi.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: codexapi
-Version: 0.3.3
+Version: 0.4.0
 Summary: Minimal Python API for running the Codex CLI.
 License: MIT
 Keywords: codex,agent,cli,openai
@@ -85,6 +85,8 @@ Resume a session and print the thread id to stderr:
 codexapi run --thread-id THREAD_ID --print-thread-id "Continue where we left off."
 ```
 
+Use `--no-yolo` to run Codex with `--full-auto` instead.
+
 Ralph loop mode repeats the same prompt until a completion promise or a max
 iteration cap is hit (0 means unlimited). Cancel by deleting
 `.codexapi/ralph-loop.local.md` or running `codexapi ralph --cancel`.
@@ -97,27 +99,27 @@ codexapi ralph --cancel --cwd /path/to/project
 
 ## API
 
-### `agent(prompt, cwd=None, yolo=False, flags=None) -> str`
+### `agent(prompt, cwd=None, yolo=True, flags=None) -> str`
 
 Runs a single Codex turn and returns only the agent's message. Any reasoning
 items are filtered out.
 
 - `prompt` (str): prompt to send to Codex.
 - `cwd` (str | PathLike | None): working directory for the Codex session.
-- `yolo` (bool): pass `--yolo` to Codex when true.
+- `yolo` (bool): pass `--yolo` to Codex when true (defaults to true).
 - `flags` (str | None): extra CLI flags to pass to Codex.
 
-### `Agent(cwd=None, yolo=False, thread_id=None, flags=None)`
+### `Agent(cwd=None, yolo=True, thread_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.
 
 - `__call__(prompt) -> str`: send a prompt to Codex and return the message.
 - `thread_id -> str | None`: expose the underlying session id once created.
-- `yolo` (bool): pass `--yolo` to Codex when true.
+- `yolo` (bool): pass `--yolo` to Codex when true (defaults to true).
 - `flags` (str | None): extra CLI flags to pass to Codex.
 
-### `task(prompt, check=None, n=10, cwd=None, yolo=False, flags=None) -> str`
+### `task(prompt, check=None, n=10, cwd=None, yolo=True, flags=None) -> str`
 
 Runs a task with checker-driven retries and returns the success summary.
 Raises `TaskFailed` when the maximum attempts are reached.
@@ -125,12 +127,12 @@ Raises `TaskFailed` when the maximum attempts are reached.
 - `check` (str | None | False): custom check prompt, default checker, or `False` to skip.
 - `n` (int): maximum number of retries after a failed check.
 
-### `task_result(prompt, check=None, n=10, cwd=None, yolo=False, flags=None) -> TaskResult`
+### `task_result(prompt, check=None, n=10, cwd=None, yolo=True, flags=None) -> TaskResult`
 
 Runs a task with checker-driven retries and returns a `TaskResult` without
 raising `TaskFailed`.
 
-### `Task(prompt, max_attempts=10, cwd=None, yolo=False, thread_id=None, flags=None)`
+### `Task(prompt, max_attempts=10, cwd=None, yolo=True, thread_id=None, flags=None)`
 
 Runs a Codex task with checker-driven retries. Subclass it and implement
 `check()` to return an error string when the task is incomplete, or return
@@ -165,8 +167,7 @@ Exception raised by `task()` when retries are exhausted.
 
 - Uses `codex exec --json` and parses JSONL events for `agent_message` items.
 - Automatically passes `--skip-git-repo-check` so it can run outside a git repo.
-- Passes `--full-auto` unless `--yolo` is enabled.
-- Passes `--yolo` when enabled (use with care).
+- Passes `--yolo` by default (use `--no-yolo` or `yolo=False` for `--full-auto`).
 - Raises `RuntimeError` if Codex exits non-zero or returns no agent message.
 
 ## Configuration