English Français العربية

com.nyx-intelligence/val

السجل الرسمي البحث والويب

QA agent for vibecoded apps. Real browser checks, your AI fixes them. Ship to green.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @nyx-intelligence/val-mcp
Claude Code 
claude mcp add val -e 'VAL_LICENSE_KEY=<your val_license_key>' -- npx -y @nyx-intelligence/val-mcp@0.10.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "val": {
            "command": "npx",
            "args": [
                "-y",
                "@nyx-intelligence/val-mcp@0.10.1"
            ],
            "env": {
                "VAL_LICENSE_KEY": "<your val_license_key>"
            }
        }
    }
}

متغيرات البيئة

  • VAL_LICENSE_KEY إلزامي سري Your Val license key (vk_...). Subscribe at val.nyx-intelligence.com (4.99 USD per month) if you do not have one.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Val QA scan — GitHub Action
  2. Requires a Val subscription
  3. Quick start
  4. Inputs
  5. Outputs
  6. What Val checks
  7. Permissions

Val QA scan — GitHub Action

Run Val, the QA agent for vibecoded apps, on every PR. Val drives a real browser against your preview URL, catches broken links, dead buttons, busted layouts, accessibility violations, and posts a report as a PR comment.

Requires a Val subscription

Val is a paid product. Get a license key at val.nyx-intelligence.com, store it as a repository secret (e.g. VAL_LICENSE_KEY), and pass it to the action.

Quick start

name: Val QA
on: pull_request

jobs:
  qa:
    runs-on: ubuntu-latest
    steps:
      - name: Deploy preview
        id: deploy
        # ... your preview deployment step (Vercel, Netlify, etc.) ...
        # outputs.url should be the preview URL

      - name: Val scan
        uses: nyx-intelligence/val-action@v1
        with:
          url: ${{ steps.deploy.outputs.url }}
          license-key: ${{ secrets.VAL_LICENSE_KEY }}
          devices: 'desktop,iPhone 14'
          fail-on: 'high'

Inputs

NameDefaultDescription
url(required)The URL Val should scan. Pass your preview deployment URL.
license-key(required)Your Val license key (vk_...). Get one at val.nyx-intelligence.com.
max-pages12Maximum same-origin pages to crawl.
devicesdesktopComma-separated device profiles, e.g. desktop,iPhone 14,Pixel 7.
fail-onhighSeverity that fails the action: high, medium, low, or never.
commenttruePost the report as a PR comment (true / false).
github-token${{ github.token }}Token used to post the PR comment.

Outputs

NameDescription
highNumber of high-severity findings.
mediumNumber of medium-severity findings.
lowNumber of low-severity findings.
report-pathPath to the raw report file.

What Val checks

  • Broken links and 4xx/5xx responses
  • Uncaught JS errors and console errors
  • Broken/missing images
  • Horizontal layout overflow on mobile
  • Clipped text in fixed containers
  • Cumulative Layout Shift (janky load)
  • A11y essentials: missing alt, unnamed buttons, unlabeled inputs, missing <html lang>
  • Multi-device: catches bugs that appear only on mobile or only on desktop

Permissions

The action needs pull-requests: write to post comments:

permissions:
  contents: read
  pull-requests: write

الأسئلة الشائعة

ما هو com.nyx-intelligence/val؟

QA agent for vibecoded apps. Real browser checks, your AI fixes them. Ship to green.

كيف أثبّت com.nyx-intelligence/val؟

يعمل على جهازك. في Claude Code: claude mcp add val -e 'VAL_LICENSE_KEY=<your val_license_key>' -- npx -y @nyx-intelligence/val-mcp@0.10.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج com.nyx-intelligence/val إلى مفتاح API؟

نعم. يتطلب VAL_LICENSE_KEY، وتضبطها في إعداداته.

هل com.nyx-intelligence/val مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون com.nyx-intelligence/val؟

ينشره Wakizara. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.