# `mix oban_claude`
[🔗](https://github.com/genagent/oban_claude/blob/v0.10.2/lib/mix/tasks/oban_claude.ex#L1)

Run claude from the CLI: `mix oban_claude <run|doctor|args>`.

A [`cheer`](https://hexdocs.pm/cheer) command tree over `ObanClaude`, so the
CLI shares one declarative definition (parsing, validation, `--help`, and shell
completion) across its subcommands:

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

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

## Examples

    mix oban_claude run "summarize the repo" --working-dir . --permission-mode plan
    mix oban_claude run "extract the facts" --json-schema "$(cat schema.json)" --json
    mix oban_claude args "review this" --model sonnet --allowed-tools Read
    mix oban_claude doctor

---

*Consult [api-reference.md](api-reference.md) for complete listing*