Skip to main content

Use Argos with Semaphore CI

Configure Semaphore CI to send screenshots to Argos visual testing platform. CI

1. Install

Install the @argos-cli package from npm:

npm i --save-dev @argos-cli

2. Set ARGOS_TOKEN as CI secret

Argos uses a token called ARGOS_TOKEN to identify to which repository the screenshots you send are related to.

  • Step 1: Get the token value
    On Argos, go to the repository you want to set and click on the "settings" tab. Store the ARGOS_TOKEN value.

  • Step 2: Create a secret in your CI
    In your Semaphore project, go to Settings > Environment Variables. Set the ARGOS_TOKEN as an environment variable and paste the value you stored in the previous step.

If you are not comfortable with storing secret, read Semaphore CI documentation about environment variables.

3. Upload the screenshots

Add the following command to your CI workflow to upload screenshots to Argos:

npx @argos-ci/cli upload ./screenshots


# 👉 Insert the steps required to take screenshots

- name: Upload screenshots to
- npx @argos-ci/cli upload ./screenshots


Congratulations, now that Argos is installed, your app screenshots will be uploaded to Argos by your CI. You are ready to start the visual testing routine!