kosli config

Synopsis

kosli config [flags]

Config global Kosli flags values and store them in $HOME/.kosli . Flag values are determined in the following order (highest precedence first):

command line flags on each executed command.
environment variables.
custom config file provided with —config-file flag.
default config file in $HOME/.kosli

You can configure global Kosli flags (the ones that apply to all/most commands) using their dedicated convenience flags (e.g. —org). API tokens are stored in the suitable credentials manager on your machine. Other Kosli flags can be configured using the —set flag which takes a comma-separated list of key=value pairs. Keys correspond to the specific flag name, capitalized. For instance: —flow would be set using —set FLOW=value

Flags

Flag	Description
`-h`, `--help`	help for config
`--set` stringToString	[optional] The key-value pairs to tag the resource with. The format is: key=value
`--unset` strings	[optional] The list of tag keys to remove from the resource.

Flags inherited from parent commands

Flag	Description
`-a`, `--api-token` string	The Kosli API token.
`-c`, `--config-file` string	[optional] The Kosli config file path. (default “kosli”)
`--debug`	[optional] Print debug logs to stdout.
`-H`, `--host` string	[defaulted] The Kosli endpoint. (default “https://app.kosli.com”)
`--http-proxy` string	[optional] The HTTP proxy URL including protocol and port number. e.g. `http://proxy-server-ip:proxy-port`
`-r`, `--max-api-retries` int	[defaulted] How many times should API calls be retried when the API host is not reachable. (default 3)
`--org` string	The Kosli organization.
`-q`, `--quiet`	[optional] Suppress non-critical warning messages. Errors and normal output are not affected. If both `--quiet` and `--debug` are set, `--debug` wins.

Examples Use Cases

These examples all assume that the flags --api-token, --org, --host, (and --flow, --trail when required), are set/provided.

configure global flags in your default config file

kosli config --org=yourOrg 
	--api-token=yourAPIToken 
	--host=https://app.kosli.com 
	--debug=false 
	--max-api-retries=3 
	--http-proxy=http://192.0.0.1:8080

configure non-global flags in your default config file

kosli config --set FLOW=yourFlowName

remove a key from the default config file

kosli config --unset FLOW

Last modified on July 21, 2026

kosli completion kosli detach-policy

⌘I

General

Top-level commands

kosli allow

kosli archive

kosli assert

kosli attest

kosli begin

kosli create

kosli delete

kosli diff

kosli disable / enable

kosli evaluate

kosli get

kosli join

kosli list

kosli log

kosli rename

kosli report

kosli request

kosli rotate

kosli snapshot

kosli unarchive

kosli update

Synopsis

Flags

Flags inherited from parent commands

Examples Use Cases

​Synopsis

​Flags

​Flags inherited from parent commands

​Examples Use Cases

Synopsis

Flags

Flags inherited from parent commands

Examples Use Cases