On this page
Overview
Argos is a visual testing platform that compares screenshots captured during tests and brings UI diffs into pull-request review. Its current positioning includes workflows for both teams and AI agents.
Features and best fit
Based on official documentation; not hands-on tested · Content checked:
Key features
Turn screenshot differences into reviewable changes
Capture interface states as images and compare them against references so layout and appearance changes that code assertions may miss can be reviewed explicitly.
Sources: [2]
Send captures from common browser-testing environments
The official JavaScript SDK provides integrations for Playwright, Cypress, Puppeteer, WebdriverIO, Storybook, and Vitest, allowing visual checks to sit inside existing test suites.
Sources: [4]
Best fit
Before adoption
The service and client SDKs live in separate repositories
argos-ci/argos contains the service, while Playwright and other upload integrations are maintained in argos-ci/argos-javascript. Adoption involves understanding both sides.
Local service development has several infrastructure prerequisites
The contributing guide requires pnpm, PostgreSQL, Docker Compose, local hostnames, mkcert certificates, and database setup, so running the service code locally is more involved than installing a test adapter.
Sources: [3]
Track a moving main branch instead of GitHub Releases
argos-ci/argos does not publish GitHub Releases. Record the commit SHA used when reproducible source evaluation matters.
Sources: [1]
Official sources
- [1]argos-ci/argos repository(2026-09-30)
- [2]Argos README(2026-09-30)
- [3]Argos contributing guide(2026-09-30)
- [4]Argos JavaScript SDK README(2026-09-30)
- [5]Argos MIT license(2026-09-30)
Supplemental curator note
Argos brings UI changes that code assertions can miss into pull-request review as screenshot diffs. Client SDKs are maintained in the separate official argos-javascript repository.
Try it in 3 steps
- 1
Install the Playwright integration
Add the official Argos integration to an existing Playwright project.
npm install --save-dev @argos-ci/playwright - 2
Configure the reporter and screenshots
Follow the official README to register the reporter in playwright.config.ts and call argosScreenshot(page, "name") for the UI states you want to compare.
Add @argos-ci/playwright/reporter and argosScreenshot() to your Playwright tests - 3
Upload from CI
Provide the project token as an environment variable and run the tests so captured screens are uploaded to an Argos build. Do not commit the token to the repository.
CI=1 ARGOS_TOKEN="<your-argos-token>" npx playwright test
Growth
Growth trends · Last 30 days
633 Stars
Trend data is still being collected.
Built with
Categories and tags
Categories
GitHub data
GitHub dataView detailed GitHub data
GitHub Topics
- testing
- testing-tools
- visual-testing
- Stars
- 633
- Forks
- 65
- Watchers
- 7
- Open issues
- 3
- Owner type
- Organization
- Primary language
- TypeScript
- License
- MIT
- Repository last updated
- Sep 30, 2026
Related information
Write a related articleShare a guide or use case for this OSS in Markdown. Articles are published after administrator approval.
Explore next
- Hoppscotch80,553 Stars
1 shared tag(s) · 2 shared category(s) · Same language
Span REST, GraphQL, realtime requests, and collection tests across web, desktop, CLI, and self-hosted API workflows
TypeScript - Insomnia40,041 Stars
1 shared tag(s) · 2 shared category(s) · Same language
combine API design, requests, testing, and CI workflows in a desktop client
TypeScript - Ladle2,989 Stars
1 shared tag(s) · 2 shared category(s) · Same language
Develop and share React component states as isolated stories
TypeScript - Kodus1,425 Stars
1 shared tag(s) · 2 shared category(s) · Same language
review pull-request diffs with repository context, team rules, and selectable LLMs across Git, CLI, and CI workflows
TypeScript - Markuplint619 Stars
1 shared tag(s) · 2 shared category(s) · Same language
lint markup against HTML and ARIA rules across HTML, React, Vue, Svelte, and other templates
TypeScript - jsdom21,695 Stars
1 shared tag(s) · 2 shared category(s)
emulate a subset of DOM and HTML standards in Node.js for testing and scraping
JavaScript
Report incorrect information
Tell us if any listing information is incorrect or outdated.