Argosとは？CIで使えるオープンソースのビジュアルテスト基盤

ページ内ナビ

概要

Argosはテスト中に取得したスクリーンショットを基準画像と比較し、UIの差分をPull Request単位で確認できるビジュアルテスト基盤です。チームだけでなくAIエージェントによるレビュー作業も想定しています。

特徴と向いている用途

公式資料に基づく紹介・実機未検証 · 内容確認日：2026-09-30

主な特徴

スクリーンショットの差分をレビュー対象にする

画面を画像として記録し、変更前後の差分を比較することで、コード上のアサーションだけでは捉えにくいレイアウトや見た目の変化を確認できます。

出典：[2]

主要なブラウザテスト環境から画像を送る

公式JavaScript SDKはPlaywright、Cypress、Puppeteer、WebdriverIO、Storybook、Vitest向けの連携を提供し、既存のテストにビジュアル確認を組み込めます。

出典：[4]

向いている用途

CI上でUI変更をPull Requestレビューに組み込みたい場合に向く

フロントエンドやデザインシステムの変更を、実装者だけでなくレビュアーも画像差分で確認したいチームに適します。

出典：[2][4]

導入前の確認

サービス本体と利用側SDKはリポジトリが分かれている

argos-ci/argosはサービス本体で、Playwrightなどからスクリーンショットを送るSDKはargos-ci/argos-javascriptで提供されています。導入時は両者の役割を分けて確認します。

出典：[2][4]

本体をローカル開発する場合は複数の周辺サービスが必要

CONTRIBUTINGではpnpm、PostgreSQL、Docker Compose、hosts設定、mkcertによる証明書、データベース初期化などを前提にしています。単純なライブラリ導入より開発環境は重めです。

出典：[3]

GitHub Releaseではなく継続更新されるmainを追う

argos-ci/argosにはGitHub Releasesが公開されていません。ソースから評価する場合は利用したcommit SHAを記録すると再現しやすくなります。

出典：[1]

参考にした公式資料

[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)

編集部からの補足

コードのテスト結果だけでは見落としやすいUIの変化を、スクリーンショット差分としてPull Requestに持ち込める点が特徴です。利用側のSDKは別の公式argos-javascriptリポジトリで提供されています。

3ステップで試す

1
Playwright連携を追加
既存のPlaywrightプロジェクトへArgos公式連携パッケージを追加します。
npm install --save-dev @argos-ci/playwright
2
Reporterとスクリーンショット取得を設定
公式READMEに沿ってReporterをplaywright.config.tsへ追加し、確認したい画面でargosScreenshot(page, "name")を呼び出します。
Add @argos-ci/playwright/reporter and argosScreenshot() to your Playwright tests
3
CIからArgosへ送信
プロジェクトトークンを環境変数に設定してテストを実行し、取得した画面をArgosのビルドへ送信します。秘密値はリポジトリへ直接保存しません。
CI=1 ARGOS_TOKEN="<your-argos-token>" npx playwright test

公式READMEで確認

成長

成長の推移 · 直近30日

633 Stars

推移データを蓄積中です。

Built with

TypeScript

カテゴリとタグ

GitHubデータ

GitHubのデータGitHubの詳細データを見る

GitHubで見る

GitHub Topics

testing
testing-tools
visual-testing

Stars: 633
Forks: 65
Watchers: 7
Open Issues: 3
所有者種別: Organization
主要言語: TypeScript
ライセンス: MIT
リポジトリ最終更新: 2026/09/30