Using configuration file
You can manage the parameters of the CLI agent by adding the configuration file codescoring-johnny-config.yaml to the directory with the agent. Below is a list of available parameters and an example of config file.
List of parameters
Composition analysis parameters
- project – name of the project in the CodeScoring platform;
- save-results – saving the results in the CodeScoring platform. Used in conjunction with the project name. The default value is
false; - license – license of the analyzed project, for example
mit; - stage – development stage. Possible values:
build,dev,source,stage,test,prod,proxy; - bom-path – path (with file name) where the generated
bom.jsonfile will be saved; - bom-format – format of the generated SBOM. Possible values:
cyclonedx_v1_6_json,cyclonedx_v1_5_json,cyclonedx_v1_4_json,cyclonedx_v1_6_ext_json,cyclonedx_v1_7_json. Default value:cyclonedx_v1_6_json; - timeout – limit on analysis waiting time (in seconds);
- 2024.52.0 branch-or-tag – a reference to a repository branch or tag, such as
refs/tags/v1.0(for thescan dirandscan filecommands); - 2024.52.0 commit – a commit hash in the version control system (for the
scan dirandscan filecommands); - 2024.52.0 hash – an image hash (for the
scan imagecommand); - 2025.7.0 cloud-resolve – use dependency resolution in cloud. Default value is
false; - 2026.27.0 create-project-categories – create project categories if they do not exist. Default value is
false; - 2026.27.0 set-as-default-version – when used together with
branch-or-tag, the specified version becomes the default version of the project. Default value isfalse.
General scan parameters
- ignore – directories that will be ignored during scanning;
- no-summary – hide summary information on the scan in the console. Default value is
false; - only-hashes – search for only direct inclusions of Open Source libraries by hashes. Default value is
false; - with-hashes – search for direct inclusions of Open Source libraries by hashes. Default value is
false; - no-recursion – disable recursive scanning for the
scan dircommand. The default value isfalse. - block-on-empty-result – blocking the build when an empty result is returned. When activated, the agent returns exit code 3 if there are no artifacts for analysis;
- 2026.20.0 include-envs – include only the listed dependency environments in the result, comma-separated, e.g.
compile,runtime. Mutually exclusive withexclude-envs; - 2026.20.0 exclude-envs – exclude the listed dependency environments from the result, comma-separated, e.g.
test,dev. Mutually exclusive withinclude-envs.
Docker image scanning parameters
- scan-files – scanning the file system inside the image. Default value is
false; - 2026.35.0 pkg-types – keep only the listed package types in the result, comma-separated. Possible values:
os-pkgs,lang-pkgs. If not set, all package types are included; - insecure-skip-tls-verify – skip TLS verification when connecting to the image registry. Default value is
false; - insecure-use-http – use the HTTP protocol when connecting to the image registry. Default value is
false; - registries – list of configurations for connecting to multiple image registries. Each list item may contain:
- authority – registry URL (for example,
docker.io,localhost:5000); - login – username for connecting to the registry;
- password – password for connecting to the registry;
- token – token for connecting to the registry. Mutually exclusive with the
loginandpasswordparameters.
- authority – registry URL (for example,
C and C++ build scanning parameters
- lib-versions – path to a JSON file with the list of versions of the libraries being analyzed;
- unresolved-file – path to the file where information about libraries with unresolved versions will be saved.
Parsing parameters for different technologies
Common parameters
- enabled – enables parsers for the given technology;
- parsers – set of parsers for manifests.
Parser parameters
- enabled – enables this parser;
- match – condition for matching suitable manifests, can be by name (
equal) or extension (extension); - properties – additional properties for environment parsers, such as the path to executables;
- dotnet-path, maven-path, gradle-path, yarn-path, go-path, sbt-path, npm-path, pnpm-path, composer-path, pip-path, poetry-path, conda-lock-path – paths to package managers for dependency resolution in the environment;
- 2026.20.0 pdm-path – path to
pdmfor dependency resolution in the environment; - 2026.27.0 rscript-path – path to
Rscriptfor dependency resolution ofrprojects in the environment; - 2026.27.0 rebar-path – path to
rebar3for dependency resolution oferlangprojects in the environment; - 2026.27.0 mix-path – path to
mixfor dependency resolution ofelixirprojects in the environment; - 2026.27.0 gleam-path – path to
gleamfor dependency resolution ofgleamprojects in the environment; - 2026.43.0 luarocks-path – path to
luarocksfor dependency resolution ofluaprojects in the environment; - 2026.43.0 dart-path – path to
dartfor dependency resolution ofdartprojects in the environment; - 2026.43.0 flutter-path – path to
flutterfor dependency resolution offlutterprojects in the environment; - 2025.45.0 pipdeptree-path – path to
pipdeptreefor dependency resolution in the environment; - 2026.3.0 bun-path – path to
bunfor dependency resolution in the environment; - 2025.45.0 uv-path – path to
uvfor dependency resolution in the environment; - 2025.13.0 swift-path – path to
swiftfor dependency resolution in the environment; - resolve-enabled – enables dependency resolution in the environment. Default value is
false; - dotnet-args, gradle-args, maven-args, sbt-args, npm-args, yarn-args, pnpm-args, composer-args, pip-args, poetry-args, conda-args – arguments to pass to the corresponding package managers when resolving dependencies in the environment;
- 2026.20.0 pdm-args – arguments to pass to
pdmduring dependency resolution in the environment; - 2026.27.0 rebar-args – arguments to pass to
rebar3during dependency resolution in the environment; - 2026.27.0 mix-args – arguments to pass to
mixduring dependency resolution in the environment; - 2026.27.0 gleam-args – arguments to pass to
gleamduring dependency resolution in the environment; - 2026.43.0 luarocks-args – arguments to pass to
luarocksduring dependency resolution in the environment; - 2026.43.0 dart-args – arguments to pass to
dartduring dependency resolution in the environment; - 2026.43.0 flutter-args – arguments to pass to
flutterduring dependency resolution in the environment; - 2025.45.0 pipdeptree-args – arguments to pass to
pipdeptreeduring dependency resolution in the environment; - 2026.3.0 bun-args – arguments to pass to
bunduring dependency resolution in the environment; - 2025.45.0 uv-args – arguments to pass to
uvduring dependency resolution in the environment; - 2025.13.0 swift-args – arguments to pass to
swiftduring dependency resolution in the environment; - configuration – configuration for the
gradle-dependency-tree_txtparser; - depth – parsing depth for the
jarparser. Default value is1; - python-version – Python version used for dependency resolution in the environment.
Archive scanning parameters
- scan – scan archives. Default value is
false; - depth – archive scanning depth. Default value is
1.
Output parameters
- 2023.48.0 format – output format for found vulnerabilities. Default value is
coloredtable. Export to formatstable,text,junit,sarif,csv,gl-dependency-scanning-report,gl-code-quality-reportis available; - 2023.48.0 group-vulnerabilities-by – field used to group vulnerabilities in the table;
- 2023.48.0 sort-vulnerabilities-by – order of fields for sorting vulnerabilities in the table;
- 2025.29.0 alerts-format – output format for the policy alerts report. Supported formats:
coloredtable,table,text,json,csv. Default value iscoloredtable; - 2026.27.0 progress-bar – progress bar format. Possible values:
spinner,text. Default value istext; - 2026.35.0 reachability-format – output format for the vulnerability reachability analysis report. Supported formats:
coloredtable,table,text,json. Supports multiformat and writing to a file, e.g.json>>reachability.json. If not set, no separate report is generated.
Platform parameters
- api_url – platform address;
- api_token – token for access to the platform;
- 2026.43.0 insecure – disables TLS certificate and hostname verification when connecting to the platform. The default value is
false. When set totrue, the server's identity is not verified; use only for temporary troubleshooting. See TLS certificate verification for details; - 2026.3.0 localization — CLI output localization language. Possible values:
en,ru. The default value isen.
Secret scanning launch parameters
- 2025.13.0 gitleaks-path – path to the Gitleaks executable file to be used during scanning;
- 2025.13.0 gl-secrets-report – enables the generation of a secrets report in GitLab format. Default:
false; - 2025.13.0 gl-secrets-report-filename – name of the generated GitLab secrets report file. Default:
gl-secrets-report.json.
Gitleaks secret scanning tool parameters
- 2025.13.0 baseline-path – path to the Gitleaks baseline report file. All previously detected secrets recorded in this file will be ignored during rescanning;
- 2025.13.0 enable-rule – list of rule IDs to be enabled during scanning;
- 2025.13.0 gitleaks-ignore-path – path to the
.gitleaksignorefile or the directory containing it. Default:.(current directory); - 2025.13.0 ignore-gitleaks-allow – ignores
gitleaks:allowcomments. Default:false; - 2025.13.0 log-level – logging level. Possible values:
trace, debug, info, warn, error, fatal. Default:info; - 2025.13.0 max-decode-depth – maximum depth for recursive decoding. A value of
0disables decoding; - 2025.13.0 max-target-megabytes – maximum file size (in megabytes) to be processed. Files exceeding this size will be skipped. Default:
0(no limit); - 2025.13.0 no-banner – disables the Gitleaks startup banner. Default:
false; - 2025.13.0 no-color – disables colored output in verbose mode. Default:
false; - 2025.13.0 redact – masks detected secrets in logs and console output. A value of 0 fully reveals secrets, while 100 completely hides them. Intermediate values, such as 20, mask 20% of the secret. Default:
0; - 2025.13.0 verbose – enables verbose output during scanning. Default:
false.
Example file
Priority of settings
Since agent startup parameters can be configured in multiple ways, if two or more methods are used at the same time, the agent will accept parameters in the following priority order:
- Value of the scan-technology command (if used);
- Value of the command flag;
- Value of environment variable;
- Value from config file.
Was this page helpful?
