# `once query affected-tests`

List test targets likely affected by changed workspace paths

## Synopsis

```text
once query affected-tests [OPTIONS]
```

## Description

Uses declared target inputs, package ownership, and reverse dependency traversal. An otherwise unowned path belongs to its nearest package. The root manifest, configured graph modules, and paths outside every known package conservatively select every test.

## Options

| Flag | Value | Default | Description |
| --- | --- | --- | --- |
| `--changed-path` | `<PATH>` |  | Changed workspace-relative path. Repeat for multiple paths |
| `-C, --directory` | `<DIR>` |  | Project root. Defaults to the current directory; the cache lives under `<project>/.once/`. Mirrors `make -C` |
| `--format` | `<FORMAT>` | `human` | Output format for Once's structured data (`cache stats`, `run`/`exec` trailers). Defaults to a human-readable rendering; pass `json` or `toon` to get machine-parseable output for scripting and for agent consumers |
| `-v, --verbose` | (flag) | `0` | Increase log verbosity. Repeat for more (-v: info, -vv: debug, -vvv: trace). Overridden by `RUST_LOG` |
| `-q, --quiet` | (flag) | `false` | Suppress human-mode success and progress trailers. Errors and the structured envelope of `--format json`/`toon` still print. Mirrors the `-q` flag of common build tools |
| `--list` | (flag) | `false` | Print the command surface at the current command depth |
| `--memory-limit` | `<SIZE>` |  | Maximum memory scheduling budget for local actions. Defaults to two thirds of the memory visible to the host or container |