Skip to content

Add completion spec: Nextflow#209

Merged
lucieleblanc merged 1 commit into
mainfrom
oz-agent/APP-3501/command-spec-nextflow
Apr 1, 2026
Merged

Add completion spec: Nextflow#209
lucieleblanc merged 1 commit into
mainfrom
oz-agent/APP-3501/command-spec-nextflow

Conversation

@lucieleblanc
Copy link
Copy Markdown
Contributor

@lucieleblanc lucieleblanc commented Apr 1, 2026

Summary

Add comprehensive completion spec for the Nextflow CLI, a reactive workflow framework for data-driven computational pipelines. Nextflow is downloaded 150,000+ times/month and has significant demand in the bioinformatics/genomics community (16 upvotes on GitHub #3397).

What's included

JSON Spec (command-signatures/json/nextflow.json)

  • 17 subcommands: run, clean, clone, config, console, drop, fs, help, info, kuberun, list, log, node, plugin, pull, secrets, self-update, view
  • 11 top-level options: -C, -D, -bg, -c/-config, -h, -log, -q/-quiet, -remote-debug, -syslog, -trace, -v/-version
  • Full run/kuberun options: container runtimes (Docker, Singularity, Apptainer, Podman, Charliecloud, Conda), reports, DAG, timeline, tracing, Tower integration, pipeline parameters
  • Nested subcommands: fs (cat/copy/delete/list/move with aliases), secrets (list/get/set/delete), plugin (install)
  • File/folder templates where appropriate (config files, work dirs, params files, DAG output, etc.)
  • Static suggestions for hub types, boolean flags, output formats

Rust Generators (src/generators/nextflow.rs)

  • run_names: Runs nextflow log -q to suggest previous run names for clean and log commands
  • downloaded_projects: Runs nextflow list to suggest cached projects for info, drop, and view commands

Generator verification

Both generators were tested end-to-end in a local Warp build against this branch. Screenshots are in the PR comments below.

run_names generator (nextflow clean + Tab):
Completions dropdown shows test_run_screenshot with "Run name" description, followed by clean options (-after, -before, -but, -dry-run, -force).

downloaded_projects generator (nextflow info + Tab):
Completions dropdown shows nextflow-io/hello with "Downloaded project" description, followed by info options (-dd, -help, -d, -h, -o).

Resolves


Conversation: https://staging.warp.dev/conversation/a65d8301-f89d-442c-9cdb-5cf944ac72b3
Run: https://oz.staging.warp.dev/runs/019d4737-8477-7199-ad46-55ad1573111d
This PR was generated with Oz.

Add comprehensive completion spec for Nextflow CLI covering:
- All 17 subcommands (run, clean, clone, config, console, drop, fs,
  help, info, kuberun, list, log, node, plugin, pull, secrets,
  self-update, view)
- Top-level options (-C, -D, -bg, -c/-config, -h, -log, -q/-quiet,
  -remote-debug, -syslog, -trace, -v/-version)
- Full run/kuberun options including container runtimes, reports,
  profiling, and pipeline parameters
- Nested subcommands for fs (cat/cp/ls/mv/rm) and secrets
  (list/get/set/delete)
- Dynamic generators for run names (nextflow log -q) used by clean
  and log subcommands
- Dynamic generators for downloaded projects (nextflow list) used by
  info, drop, and view subcommands

Resolves APP-3501 / GitHub #3397 (16 upvotes, 150k+ monthly downloads)

Co-Authored-By: Oz <oz-agent@warp.dev>
@linear
Copy link
Copy Markdown

linear Bot commented Apr 1, 2026

APP-3501 [Completions] Create `nextflow` completion spec

No spec exists for Nextflow. Need to create spec from scratch covering all subcommands and options. 16👍 on GitHub — significant bioinformatics/genomics user demand. Nextflow is downloaded 150,000+ times/month.

See GitHub #3397

Copy link
Copy Markdown
Contributor Author

Generator Screenshots

run_names generator (nextflow clean + Tab)

Shows previous run names from nextflow log -q:

downloaded_projects generator (nextflow info + Tab)

Shows downloaded projects from nextflow list:

Screenshots taken from a local Warp build using command-signatures from this branch.

Copy link
Copy Markdown
Contributor Author

Generator Screenshots (with images)

Tested in a local Warp build with this branch's command-signatures.

run_names generator (nextflow clean + Tab)

Shows 'test_run_screenshot' with 'Run name' description from nextflow log -q.

downloaded_projects generator (nextflow info + Tab)

Shows 'nextflow-io/hello' with 'Downloaded project' description from nextflow list.

Screenshots are attached below.

@lucieleblanc lucieleblanc marked this pull request as ready for review April 1, 2026 18:51
@lucieleblanc
Copy link
Copy Markdown
Contributor Author

Manually uploading the screenshots:

run_names generator:

image

downloaded_projects generator:

image

@lucieleblanc lucieleblanc changed the title Add completion spec: Nextflow (nextflow) Add completion spec: Nextflow Apr 1, 2026
@lucieleblanc lucieleblanc requested review from oz-agent April 1, 2026 20:23
@lucieleblanc lucieleblanc merged commit a32a6b8 into main Apr 1, 2026
3 checks passed
@lucieleblanc lucieleblanc deleted the oz-agent/APP-3501/command-spec-nextflow branch April 1, 2026 20:39
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.

3 participants