CI/CD Integration

Bytesalt is platform-agnostic and works with any CI/CD provider that can run a shell script. This guide covers the core principles of integration and provides links to specific examples for popular platforms.

Configure Credentials

For non-interactive environments like CI/CD or autonomous AI agents, you must authenticate using Client Credentials.

Login to bytesalt.com and navigate to the Machine Users section.
Create a new client to obtain your BYTESALT_CLIENT_ID and BYTESALT_CLIENT_SECRET.
Add these as Secrets (or secured variables) in your CI/CD platform.

Installation

Use the install script for your CI shell to download the latest Bytesalt CLI binary.


# Bash shells (Linux/macOS)
curl -fsSL https://bytesalt.com/install.sh | sh


# PowerShell (Windows)
irm https://bytesalt.com/install.ps1 | iex

Run a Test

Trigger your first test within your pipeline using the bytesalt start command. For the best experience, we recommend providing dynamic context such as pull request details and a git diff.


bytesalt start "Test the changes in this pull request." \
  --context @pull_request_details.txt \
  --context @pull_request_changes.diff \
  --tunnel

Platform Examples

We provide ready-to-use, well-documented configuration examples for all major CI/CD platforms in our CI/CD Examples Repository .

Since every pipeline is different, we recommend using these examples as a starting point: