Add completion spec: Nextflow#209
Merged
Merged
Conversation
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>
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 |
Contributor
Author
Generator Screenshots
|
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. |
Contributor
Author
peicodes
approved these changes
Apr 1, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.


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)run,clean,clone,config,console,drop,fs,help,info,kuberun,list,log,node,plugin,pull,secrets,self-update,view-C,-D,-bg,-c/-config,-h,-log,-q/-quiet,-remote-debug,-syslog,-trace,-v/-versionrun/kuberunoptions: container runtimes (Docker, Singularity, Apptainer, Podman, Charliecloud, Conda), reports, DAG, timeline, tracing, Tower integration, pipeline parametersfs(cat/copy/delete/list/move with aliases),secrets(list/get/set/delete),plugin(install)Rust Generators (
src/generators/nextflow.rs)run_names: Runsnextflow log -qto suggest previous run names forcleanandlogcommandsdownloaded_projects: Runsnextflow listto suggest cached projects forinfo,drop, andviewcommandsGenerator verification
Both generators were tested end-to-end in a local Warp build against this branch. Screenshots are in the PR comments below.
run_namesgenerator (nextflow clean+ Tab):Completions dropdown shows
test_run_screenshotwith "Run name" description, followed by clean options (-after,-before,-but,-dry-run,-force).downloaded_projectsgenerator (nextflow info+ Tab):Completions dropdown shows
nextflow-io/hellowith "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.