# `Kinda.CommandError`
[🔗](https://github.com/beaver-lodge/kinda/blob/main/lib/kinda/error/command.ex#L1)

The exception raised when an external command cannot be run successfully.

In addition to its human-readable message, the exception retains the exact
command, arguments, working directory, exit status and captured output so
callers can inspect failures without parsing text.

# `t`

```elixir
@type t() :: %Kinda.CommandError{
  __exception__: term(),
  args: [String.t()],
  command: String.t() | nil,
  cwd: Path.t() | nil,
  message: String.t() | nil,
  output: String.t() | nil,
  reason: term(),
  stage: atom() | nil,
  status: non_neg_integer() | nil
}
```

---

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