Skip to content

docs(nx-cloud): document --targets flag for start-agent#35554

Open
edbzn wants to merge 1 commit intonrwl:masterfrom
edbzn:docs/nx-cloud-start-agent-targets
Open

docs(nx-cloud): document --targets flag for start-agent#35554
edbzn wants to merge 1 commit intonrwl:masterfrom
edbzn:docs/nx-cloud-start-agent-targets

Conversation

@edbzn
Copy link
Copy Markdown
Contributor

@edbzn edbzn commented May 4, 2026

Current Behavior

nx-cloud start-agent supports a --targets <csv> flag (visible via nx-cloud start-agent --help) that pins an agent to a comma-separated subset of target names. The flag is not mentioned on https://nx.dev/docs/reference/nx-cloud-cli or in the Manual DTE guide, so users hitting OOM or contention on memory-constrained runners cannot discover it without reading the bundled CLI source.

Expected Behavior

The flag is documented in:

  • the nx-cloud start-agent Options table on the Cloud CLI reference, with a short usage example
  • the Manual DTE guide, with a small example showing per-pool partitioning to isolate memory-heavy task families (e2e, builds, component-tests)

Related Issue(s)

N/A — documentation gap discovered while debugging OOM-kill failures on a manual-DTE GitHub Actions setup.

@edbzn edbzn requested a review from a team as a code owner May 4, 2026 08:30
@edbzn edbzn requested a review from leosvelperez May 4, 2026 08:30
@netlify
Copy link
Copy Markdown

netlify Bot commented May 4, 2026

👷 Deploy request for nx-docs pending review.

Visit the deploys page to approve it

Name Link
🔨 Latest commit 8047b82

@netlify
Copy link
Copy Markdown

netlify Bot commented May 4, 2026

👷 Deploy request for nx-dev pending review.

Visit the deploys page to approve it

Name Link
🔨 Latest commit 8047b82

@edbzn edbzn force-pushed the docs/nx-cloud-start-agent-targets branch from 5261e4f to 55c7609 Compare May 4, 2026 08:32
The bundled nx-cloud start-agent CLI advertises a --targets <csv> flag
in its --help output, but it is not documented on nx.dev. Add it to the
Cloud CLI reference and to the Manual DTE guide, with an example showing
per-pool partitioning to isolate memory-heavy task families (e2e, builds,
component-tests) on memory-constrained runners.
@edbzn edbzn force-pushed the docs/nx-cloud-start-agent-targets branch from 55c7609 to 8047b82 Compare May 4, 2026 08:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant