mix oban_codex (oban_codex v0.1.0)

Copy Markdown View Source

Run Codex from the CLI: mix oban_codex <run|doctor|args>.

A cheer command tree over ObanCodex, so the CLI shares one declarative definition (parsing, validation, --help, and shell completion) across its subcommands:

  • mix oban_codex run "<prompt>" [flags] -- fire a single, queueless Codex run and print the verdict.
  • mix oban_codex doctor -- a fleet pre-flight check (binary present, usable version, authenticated); exits non-zero if the environment is not ready.
  • mix oban_codex args "<prompt>" [flags] -- build and print the validated ObanCodex.Args map from flags, without running Codex (a dry run).

Every run / args flag maps to an ObanCodex.Args.new/1 option; the prompt is the first positional argument. mix oban_codex <cmd> --help shows the full flag list. Scaffolding a project is separate: mix oban_codex.install (an Igniter task).

Examples

mix oban_codex run "summarize the repo" --working-dir . --sandbox read_only
mix oban_codex run "extract the facts" --output-schema schema.json --json
mix oban_codex args "review this" --model gpt-5 --approval-policy never
mix oban_codex doctor