Introduction to the cictl Command Line Tool

The information in this article applies to cictl version 3.0.0 and newer. Check which version of cictl you have installed:

cictl --version

 

cictl comes with an integrated help

cictl help

cictl-integated-help

 

The first thing you might want to do is to install the completion scripts. This teaches your shell to autocomplete cictl commands, which save you most of the typing.

If you are using bash under Linux, just run

cictl completion bash > /etc/bash_completion.d/cictl

If you are using a different shell, you can use

cictl completion --help

to get a detailed manual on how to do this for every supported shell. Currently, Bash, Zsh, fish, and PowerShell are supported.

The cictl tool needs a running ci-daemon it can connect to. You can start the local daemon using

ci-daemon -v1 --alsologtostderr

Alternatively, you can tell cictl to connect to the CI Fuzz Cloud to manage your projects and run your fuzz tests there. To log in to the CI Fuzz cloud, first set the server address by running

cictl config set server grpc-api.code-intelligence.com:443

then run

cictl login

and enter your access token. For information about how to create an access token, read Continuous Fuzzing Setup

cictl-login_redacted

First, lists all projects that are currently initialized.

cictl list projects

list-projects