Show every node's cache state, last materialization and artifact shape (read-only)

Usage: barca status [OPTIONS] [ARGS]...

Arguments:
  [ARGS]...
          Target(s), then optional files/directories; omit files to discover the project

Options:
      --json
          Emit JSON on stdout (the default when stdout is not a terminal)

      --pretty
          Emit human-readable output (the default when stdout is a terminal)

  -l, --limit <LIMIT>
          Maximum nodes, in topological order (default: every node in JSON, 100 in a human table)

      --all
          Show every node (no limit)

      --fields <FIELDS>
          Select JSON fields as a comma-separated list; implies --json

          [possible values: id, name, kind, inputs, partitioned, cache, partitions, last_materialization, last_bytes_change, shape, env, undeclared_env, local, schedule]

      --sample <N>
          Include up to N sample rows from each json/parquet/CSV artifact (off by default; pickles are never sampled)

      --state <STATE>
          Show only nodes in these cache states (comma-separated): cached, unsynced, stale, never_run, partial, blocked, unknown, always_runs. The summary still counts every node

      --problems
          Show only nodes that need attention: not cached (unsynced, stale, never_run, partial, blocked, unknown), a task or sensor whose last run failed, or a paused or failing schedule

      --env <ENV>
          Use a separate cache and history for this environment

      --server [<URL>]
          Use a server (URL or configured); get/run execute its deployed code

      --local
          Use independent local state; ignore the configured server

  -h, --help
          Show concise command help

      --examples
          Show all command examples without running anything

Examples:
  barca status                             # every node in the project
  barca status pipeline.py                 # table in a terminal (JSON when piped): kind, cache state, last run, shape
  barca status total pipeline.py           # only `total` and its upstream cone
  barca status total,orders pipeline.py    # several targets: the union of their cones
  barca status pipeline.py --json          # {target, targets, nodes, summary, total, truncated, root}, even in a terminal
  barca status pipeline.py --pretty        # the table, even when piped
  barca status pipeline.py --fields id,cache   # JSON with only these keys per node
  barca status scored pipeline.py --json   # partitions.changed: why each missing key will run
  barca status big.py --limit 20           # first 20 nodes; the summary counts all
  barca status total pipeline.py --json --sample 5   # add up to 5 sample rows per json/parquet/CSV artifact
  barca status pipeline.py --env dev       # state recorded in another environment
  barca status total --server              # cache state on the configured barca server
  barca status total --json                # with a server configured: its ledger, plus `local` per node
  barca status total --local               # this machine's own state, even with a server configured
  barca status --problems                  # only nodes that need attention: not cached, a failed run, a paused or failing schedule
  barca status --state stale,never_run     # only nodes in these cache states; the summary still counts every node
  barca status --problems --server         # what needs attention on the configured server

More: barca docs status, barca docs agents
