| 0 | -The job exited with a status of 0 (success) | -
| 1 | -The job exited with a status of 1 (most common error status) | -
| 128 + signal number | -The job was terminated by a signal (see note below) | -
| 255 | -The agent was gracefully terminated | -
| -1 | -Buildkite lost contact with the agent or it stopped reporting to us | -
| Exit code | -Signal | -Name | -Description | -
| 130 | -2 | -SIGINT | -Terminal interrupt signal | -
| 137 | -9 | -SIGKILL | -Kill (cannot be caught or ignored) | -
| 139 | -11 | -SIGSEGV | -Segmentation fault; Invalid memory reference | -
| 141 | -13 | -SIGPIPE | -Write on a pipe with no one to read it | -
| 143 | -15 | -SIGTERM | -Termination signal (graceful) | -
--log-level value #Set the log level for the agent, making logging more or less verbose. Defaults to notice. Allowed values are: debug, info, error, warn, fatal (default: "notice")
Environment variable: $BUILDKITE_AGENT_LOG_LEVEL
--experiment value #Enable experimental features within the buildkite-agent
Environment variable: $BUILDKITE_AGENT_EXPERIMENT
--profile value #Enable a profiling mode, either cpu, memory, mutex or block
Environment variable: $BUILDKITE_AGENT_PROFILE
--no-multipart-artifact-upload #For Buildkite-hosted artifacts, disables the use of multipart uploads. Has no effect on uploads to other destinations such as custom cloud buckets
Environment variable: $BUILDKITE_NO_MULTIPART_ARTIFACT_UPLOAD
--lifetime value #The time (in seconds) the OIDC token will be valid for before expiry. Must be a non-negative integer. If the flag is omitted or set to 0, the API will choose a default finite lifetime. (default: 0)
--job value #Buildkite Job Id to claim in the OIDC token
Environment variable: $BUILDKITE_JOB_ID
--claim value #Claims to add to the OIDC token
Environment variable: $BUILDKITE_OIDC_TOKEN_CLAIMS
--aws-session-tag value #Add claims as AWS Session Tags
Environment variable: $BUILDKITE_OIDC_TOKEN_AWS_SESSION_TAGS
--agent-access-token value #The access token used to identify the agent
Environment variable: $BUILDKITE_AGENT_ACCESS_TOKEN
--endpoint value #The Agent API endpoint (default: "https://agent.buildkite.com/v3")
Environment variable: $BUILDKITE_AGENT_ENDPOINT
--no-http2 #Disable HTTP2 when communicating with the Agent API.
Environment variable: $BUILDKITE_NO_HTTP2
--signing-jwks-key-id value #The JWKS key ID to use when signing the pipeline. If omitted, and the signing JWKS contains only one key, that key will be used.
Environment variable: $BUILDKITE_AGENT_SIGNING_JWKS_KEY_ID
--signing-aws-kms-key value #The KMS KMS key ID, or key alias used when signing and verifying the pipeline.
Environment variable: $BUILDKITE_AGENT_SIGNING_AWS_KMS_KEY
--debug-signing #Enable debug logging for pipeline signing. This can potentially leak secrets to the logs as it prints each step in full before signing. Requires debug logging to be enabled
Environment variable: $BUILDKITE_AGENT_DEBUG_SIGNING
--verification-failure-behavior value #The behavior when a job is received without a signature. One of: [block warn]. Defaults to block (default: "block")
Environment variable: $BUILDKITE_AGENT_JOB_VERIFICATION_NO_SIGNATURE_BEHAVIOR
--verification-failure-behavior value #The behavior when a job is received without a valid verifiable signature (without a signature, with an invalid signature, or with a signature that fails verification). One of: [block warn]. Defaults to block (default: "block")
Environment variable: $BUILDKITE_AGENT_JOB_VERIFICATION_NO_SIGNATURE_BEHAVIOR
--disable-warnings-for value #A list of warning IDs to disable
Environment variable: $BUILDKITE_AGENT_DISABLE_WARNINGS_FOR
--token value #Your account agent token
Environment variable: $BUILDKITE_AGENT_TOKEN
--endpoint value #The Agent API endpoint (default: "https://agent.buildkite.com/v3")
Environment variable: $BUILDKITE_AGENT_ENDPOINT
--no-http2 #Disable HTTP2 when communicating with the Agent API.
Environment variable: $BUILDKITE_NO_HTTP2
--debug-http #Enable HTTP debug mode, which dumps all request and response bodies to the log
Environment variable: $BUILDKITE_AGENT_DEBUG_HTTP
--trace-http #Enable HTTP trace mode, which logs timings for each HTTP request. Timings are logged at the debug level unless a request fails at the network level in which case they are logged at the error level
Environment variable: $BUILDKITE_AGENT_TRACE_HTTP
--no-color #Don't show colors in logging
Environment variable: $BUILDKITE_AGENT_NO_COLOR
--debug #Enable debug mode. Synonym for `--log-level debug`. Takes precedence over `--log-level`
Environment variable: $BUILDKITE_AGENT_DEBUG
--log-level value #Set the log level for the agent, making logging more or less verbose. Defaults to notice. Allowed values are: debug, info, error, warn, fatal (default: "notice")
Environment variable: $BUILDKITE_AGENT_LOG_LEVEL
--strict-single-hooks #Enforces that only one checkout hook, and only one command hook, can be run
Environment variable: $BUILDKITE_STRICT_SINGLE_HOOKS
--kubernetes-exec #This is intended to be used only by the Buildkite k8s stack (github.com/buildkite/agent-stack-k8s); it enables a Unix socket for transporting logs and exit statuses between containers in a pod
Environment variable: $BUILDKITE_KUBERNETES_EXEC
--trace-context-encoding value #Sets the inner encoding for BUILDKITE_TRACE_CONTEXT. Must be either json or gob (default: "gob")
Environment variable: $BUILDKITE_TRACE_CONTEXT_ENCODING
--no-multipart-artifact-upload #For Buildkite-hosted artifacts, disables the use of multipart uploads. Has no effect on uploads to other destinations such as custom cloud buckets
Environment variable: $BUILDKITE_NO_MULTIPART_ARTIFACT_UPLOAD
--tags-from-ec2 #Include the host's EC2 meta-data as tags (instance-id, instance-type, and ami-id)
Environment variable: $BUILDKITE_AGENT_TAGS_FROM_EC2
--tags-from-gcp #Include the host's Google Cloud instance meta-data as tags (instance-id, machine-type, preemptible, project-id, region, and zone)
Environment variable: $BUILDKITE_AGENT_TAGS_FROM_GCP