| name | ocp-pipelines-cli-reference |
| metadata | {"author":"rhoai3-coding-demo","version":"1.0.0","platform-family":"ocp","platform-baseline":"repo","ocp-baseline":"repo","skill-group":"OpenShift Platform"} |
| description | Use when referencing tkn CLI commands for OpenShift Pipelines: tkn pipeline, tkn pipelinerun, tkn task, tkn taskrun, tkn clustertask, tkn hub, tkn triggerbinding, tkn triggertemplate, tkn eventlistener, tkn condition, opc results, and CLI installation for OpenShift Pipelines 1.22. Do NOT use for pipeline concepts (use ocp-pipelines-about), installing the operator (use ocp-pipelines-install-config), or creating CI/CD pipelines (use ocp-pipelines-cicd).
|
OCP Pipelines CLI Reference
Use this skill to ground tkn CLI command reference in the
official Red Hat OpenShift Pipelines 1.22 CLI reference for the active
baseline in docs/PLATFORM_BASELINE.md.
Source Grounding
Read references/source-capture.md before using product behavior. Official Red
Hat documentation is product authority.
CLI Command Groups
Installation
tkn — available via tar.gz archive (Linux, macOS, Windows) or RPMtkn-pac — Pipelines as Code CLI (bundled)opc — OpenShift Pipelines Client (Technology Preview, bundled)
Utility Commands
tkn — parent command, displays all optionstkn completion [bash|zsh] — shell prompt completion codetkn version — print version information
Pipeline Management (tkn pipeline)
tkn pipeline --help — display helptkn pipeline delete <name> -n <namespace> — delete a pipelinetkn pipeline describe <name> — describe a pipelinetkn pipeline list — list pipelinestkn pipeline logs -f <name> — stream live logstkn pipeline start <name> — start a pipeline
Pipeline Run Management (tkn pipelinerun)
tkn pipelinerun -h — display helptkn pipelinerun cancel <name> -n <namespace> — cancel a pipeline runtkn pipelinerun delete <name1> <name2> -n <namespace> — delete runstkn pipelinerun delete -n <namespace> --keep 5 — delete all except N most recenttkn pipelinerun delete --all — delete all (skips running since Pipelines 1.6)tkn pipelinerun describe <name> -n <namespace> — describe a runtkn pipelinerun list -n <namespace> — list runstkn pipelinerun logs <name> -a -n <namespace> — display all task/step logs
Task Management (tkn task)
tkn task -h — display helptkn task delete <name1> <name2> -n <namespace> — delete taskstkn task describe <name> -n <namespace> — describe a tasktkn task list -n <namespace> — list taskstkn task start <name> -s <service_account> -n <namespace> — start a task
Task Run Management (tkn taskrun)
tkn taskrun -h — display helptkn taskrun cancel <name> -n <namespace> — cancel a task runtkn taskrun delete <name1> <name2> -n <namespace> — delete task runstkn taskrun delete -n <namespace> --keep 5 — delete all except N most recenttkn taskrun describe <name> -n <namespace> — describe a task runtkn taskrun list -n <namespace> — list task runstkn taskrun logs -f <name> -n <namespace> — display live logs
Pipeline Resource Management (tkn resource)
tkn resource -h — display helptkn resource create -n <namespace> — create (interactive)tkn resource delete <name> -n <namespace> — deletetkn resource describe <name> -n <namespace> — describetkn resource list -n <namespace> — list
Trigger Management
EventListener (tkn eventlistener)
tkn eventlistener -h — display helptkn eventlistener delete <name1> <name2> -n <namespace> — deletetkn eventlistener describe <name> -n <namespace> — describetkn eventlistener list -n <namespace> — listtkn eventlistener logs <name> -n <namespace> — display logs
TriggerBinding (tkn triggerbinding)
tkn triggerbinding -h — display helptkn triggerbinding delete <name1> <name2> -n <namespace> — deletetkn triggerbinding describe <name> -n <namespace> — describetkn triggerbinding list -n <namespace> — list
TriggerTemplate (tkn triggertemplate)
tkn triggertemplate -h — display helptkn triggertemplate delete <name1> <name2> -n <namespace> — deletetkn triggertemplate describe <name> -n <namespace> — describetkn triggertemplate list -n <namespace> — list
ClusterTriggerBinding (tkn clustertriggerbinding)
tkn clustertriggerbinding -h — display helptkn clustertriggerbinding delete <name1> <name2> — delete (cluster-scoped)tkn clustertriggerbinding describe <name> — describetkn clustertriggerbinding list — list all
Hub Interaction (tkn hub)
tkn hub -h — display helptkn hub --api-server <url> — interact with a hub API servertkn hub downgrade task <name> --to <version> -n <namespace> — downgrade resourcetkn hub get [pipeline|task] <name> --from <catalog> --version <version> — get manifesttkn hub info task <name> --from <catalog> --version <version> — display infotkn hub install task <name> --from <catalog> --version <version> -n <namespace> — installtkn hub reinstall task <name> --from <catalog> --version <version> -n <namespace> — reinstalltkn hub search --tags <tag> — search by tagstkn hub upgrade task <name> --to <version> -n <namespace> — upgrade resource
Global Options
--help, -h — display help for any command-n <namespace> — target namespace (available on most commands)
Key Behaviors
tkn pipelinerun delete --all does not delete running resources (since Pipelines 1.6)tkn resource create is interactive and prompts for resource type and valuestkn hub commands require a Tekton Hub API server (default: api.hub.tekton.dev)opc is Technology Preview and not supported for production use- Tab completion is available for bash and zsh via
tkn completion
Workflow
- Confirm the active OpenShift baseline in
docs/PLATFORM_BASELINE.md.
- Read
references/official-doc-extraction.md for full command details.
- Identify the relevant command group (pipeline, task, trigger, hub).
- Use the exact command syntax documented above.
- For live operations, use the repo environment guard.
- Validate with
references/source-capture.md boundaries.
Related Skills
- Use
ocp-pipelines-about for pipeline concepts and Tekton CRDs.
- Use
ocp-pipelines-install-config for installing the operator.
- Use
ocp-pipelines-release-notes for release notes and known issues.
- Use
ocp-cicd-builds for OpenShift Builds (BuildConfig, Shipwright).
References
references/source-capture.mdreferences/official-doc-extraction.md
