Need help with cli?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

245 Stars 146 Forks Apache License 2.0 967 Commits 104 Opened issues


A CLI for interacting with Tekton!

Services available


Need anything else?

Contributors list

Tekton Pipelines CLI (

Go Report Card

Tekton logo

The Tekton Pipelines CLI project provides a command-line interface (CLI) for interacting with Tekton, an open-source framework for Continuous Integration and Delivery (CI/CD) systems.


Download the latest binary executable for your operating system.

Mac OS X

  brew install tektoncd-cli
  # Get the tar.xz
  curl -LO
  # Extract tkn to your PATH (e.g. /usr/local/bin)
  sudo tar xvzf tkn_0.18.0_Darwin_x86_64.tar.gz -C /usr/local/bin tkn


choco install tektoncd-cli --confirm
#Create directory
New-Item -Path "$HOME/tektoncd/cli" -Type Directory
# Download file
Start-BitsTransfer -Source -Destination "$HOME/tektoncd/cli/."
# Uncompress zip file
Expand-Archive $HOME/tektoncd/cli/*.zip -DestinationPath C:\Users\Developer\tektoncd\cli\.
#Add to Windows `Environment Variables`
[Environment]::SetEnvironmentVariable("Path",$($env:Path + ";$Home\tektoncd\cli"),'User')

Linux tarballs

  # Get the tar.xz
  curl -LO
  # Extract tkn to your PATH (e.g. /usr/local/bin)
  sudo tar xvzf tkn_0.18.0_Linux_x86_64.tar.gz -C /usr/local/bin/ tkn
  # Get the tar.xz
  curl -LO
  # Extract tkn to your PATH (e.g. /usr/local/bin)
  sudo tar xvzf tkn_0.18.0_Linux_arm64.tar.gz -C /usr/local/bin/ tkn
  # Get the tar.gz
  curl -LO
  # Extract tkn to your PATH (e.g. /usr/local/bin)
  sudo tar xvzf tkn_0.18.0_Linux_s390x.tar.gz -C /usr/local/bin/ tkn
  # Get the tar.gz
  curl -LO
  # Extract tkn to your PATH (e.g. /usr/local/bin)
  sudo tar xvzf tkn_0.18.0_Linux_ppc64le.tar.gz -C /usr/local/bin/ tkn

Linux RPMs

If you are running on any of the following rpm based distros:

  • Latest Fedora and the two versions behind.
  • Centos Stream
  • EPEL
  • Latest RHEL

you would be able to use @chmouel's unofficial copr package repository by running the following commands:

  dnf copr enable chmouel/tektoncd-cli
  dnf install tektoncd-cli

On any other RPM based distros, you can install the rpm directly:

    rpm -Uvh

Linux Debs

If you are running on the latest LTS Ubuntu or Debian, you can use the TektonCD CLI PPA:

  sudo apt update;sudo apt install -y gnupg
  sudo apt-key adv --keyserver --recv-keys 3EFE0E0A2F2F60AA
  echo "deb focal main"|sudo tee /etc/apt/sources.list.d/tektoncd-ubuntu-cli.list
  sudo apt update && sudo apt install -y tektoncd-cli

The PPA may work with older releases, but that hasn't been tested.

On any other Debian or Ubuntu based distro, you can simply install the binary package directly with

  curl -LO
  dpkg -i tektoncd-cli-0.18.0_Linux-64bit.deb


You can install

from nixpkgs on any system that supports the
package manager.
nix-env --install tektoncd-cli

Homebrew on Linux

You can install the latest tektoncd-cli if you are using Homebrew on Linux as for the osx version you need to simply do :

brew install tektoncd-cli

Source install

If you have go installed and you want to compile the CLI from source, you can checkout the Git repository and run the following commands:

  export GO111MODULE=on
  make bin/tkn

This will output the

binary in

as a

will find any binary named
on your PATH and consider it as a plugin. After installing tkn, create a link as kubectl-tkn
$ ln -s /usr/local/bin/tkn /usr/local/bin/kubectl-tkn
Run the following to confirm tkn is available as a plugin:
$ kubectl plugin list
You should see the following after running kubectl plugin list if tkn is available as a plugin:
If the output above is shown, run kubectl-tkn to see the list of available tkn commands to run.

Useful Commands

The following commands help you understand and effectively use the Tekton CLI:

For every

command, you can use
flags to display specific help for that command.

Disable Color and Emojis in Output

For many

commands, color and emojis by default will appear in command output.
offers two approaches for disabling color and emojis from command output.

To remove the color and emojis from all

command output, set the environment variable
, such as shown below:
export NO_COLOR=""

More information on

can be found in the

To remove color and emojis from the output of a single command execution, the

option can be used with any command, such as in the example below:
tkn taskrun describe --no-color

Want to contribute

We are so excited to have you!

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.