Argus

v0.6.8 — MIT licensed

Crafted by CGArtLab

Frontend design code review, done right.

Argus is a cross-platform AI coding agent specialized in frontend design code review — it catches hardcoded values, design token violations, accessibility gaps, dark mode breaks, and framework API misuse, then hands you copy-ready fixes.

Install the AppRead the docs

Runs standalone in any agent framework, or as an automated GitHub App review gate.

Seven review dimensions

Every file is audited against the same standards. Findings are grouped by severity, and every issue ships with a copy-ready fix.

  • Design Token Audit

    Detects bare oklch(), hex, and rgb() colors outside :root declarations and flags every component rule that should reference a var(--ds-*) token.

  • Hardcoded Value Detection

    Catches magic numbers in spacing, radii, and type scale — any numeric value that should be a design token but is not.

  • Accessibility Review

    Enforces the WCAG AA baseline: aria-label on icon buttons, alt text on images, visible focus indicators, and contrast-safe colors.

  • Dark Mode Coverage

    Verifies every color token declared in :root has a [data-theme="dark"] override so themes never silently break.

  • CSS Consistency

    Checks for duplicate rules, invalid BEM selectors, and empty catch blocks that erode long-term maintainability.

  • HTML Structure Validation

    Confirms semantic elements are used correctly — buttons for actions, links for navigation, no misuse of interactive elements.

  • Framework API Usage

    Stack-aware validation against official docs for React, Vue, Angular, Svelte, and Astro — hooks, directives, lifecycles, and anti-patterns.

How it works

The GitHub App authenticates, your workflow calls the composite action, and the rules are injected into the review prompt at runtime.

  1. argus-flash App

    github.com/apps/argus-flash

  2. Workflow

    review.yml in your repository

  3. Composite Action

    cgartlab/argus/.github/actions/argus-review@main

  4. Rules

    AGENTS.md + SKILL.md injected at runtime

  5. Review Result

    PR comment from argus-flash[bot]

Dynamic rules. AGENTS.md and SKILL.md are read at runtime by the composite action. Update them in the Argus repository and every consumer repository picks up the changes on its next review — no consumer-side changes required.

Up and running in three steps

Install the app, add two secrets, create one workflow — every PR from then on gets a full design review.

  1. Install the App

    Install argus-flash from the GitHub Marketplace and grant it access to the repositories you want reviewed.

    github.com/apps/argus-flash

  2. Add Secrets

    Store your GitHub App ID and private key in your repository Actions secrets.

    secrets.YOUR_APP_ID

  3. Create a Workflow

    Add a minimal review workflow that calls the argus-review composite action. Every PR gets a design review comment.

    cgartlab/argus/.github/actions/argus-review@main

One workflow file

This is the entire workflow. Copy it into your repository, install the app, and every pull request receives a design review fromargus-flash[bot].

See the full guide
.github/workflows/argus-review.ymlYAML
name: Argus-Flash Review
on: [pull_request]
jobs:
  review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
        with: { persist-credentials: false }

      - name: Generate argus-flash token
        id: app-token
        uses: actions/create-github-app-token@v1
        with:
          app-id: ${{ secrets.ARGUS_FLASH_APP_ID }}
          private-key: ${{ secrets.ARGUS_FLASH_PRIVATE_KEY }}

      - uses: cgartlab/argus/.github/actions/argus-review@main
        with:
          github-token: ${{ steps.app-token.outputs.token }}
          api-key: ${{ secrets.OPENCODE_API_KEY }}