‏ProofShot: چشم‌های AI Coding Agent

ایجنت‌های کدنویسی AI یه مشکل اساسی دارن: کور کار می‌کنن. کد می‌نویسن ولی نمی‌تونن ببینن رابط کاربری درست به‌نظر می‌رسه، فیچر واقعاً کار می‌کنه، یا خطایی پرتاب شده. ProofShot این حلقه‌ی ناقص رو می‌بنده — یه CLI اوپن‌سورس که روی هر ایجنتی نصب می‌شه و یه workflow تأیید کامل بهش می‌ده.

ProofShot سه مرحله داره: start (باز کردن مرورگر و شروع ضبط)، test (ایجنت مرورگر رو کنترل می‌کنه) و stop (بسته‌بندی همه‌ی artifacts). فرایند کار اینجوریه:

# 1. شروع ضبط و راه‌اندازی سرور
proofshot start --run "npm run dev" --port 3000 --description "Login form verification"

# 2. ایجنت مرورگر رو هدایت می‌کنه
agent-browser open http://localhost:3000/login
agent-browser fill @e2 "test@example.com"
agent-browser click @e5

# 3. توقف و تولید گزارش
proofshot stop

خروجی هر session یه پوشه‌ی timestamped توی ./proofshot-artifacts/ می‌سازه. این پوشه شامل فایل ویدیویی session.webm، یه viewer.html تعاملی با نوار scrub و تایم‌لاین، گزارش SUMMARY.md، اسکرین‌شات‌های مرحله‌ای، لاگ سرور و لاگ کنسول مرورگره. viewer حتی لاگ‌ها رو با زمان ویدیو sync می‌کنه تا بشه دقیقاً دید کدوم لحظه خطا اتفاق افتاده.

ProofShot با ابزارهایی مثل Playwright MCP یا DevTools MCP فرق داره. اون‌ها برای debugging زنده و بازرسی DOM ساخته شدن، ولی ProofShot یه لایه‌ی تأیید (verification layer) روی agent-browser (ابزار Vercel) هست که session management، تشخیص خطا، sync تایم‌استمپ، viewer تعاملی و آپلود روی PR رو اضافه می‌کنه.

دستور proofshot pr می‌تونه تمام artifacts رو به PR گیت‌هاب آپلود کنه و یه کامنت فرمت‌شده با اسکرین‌شات‌های inline بسازه. همچنین proofshot diff برای visual regression — مقایسه‌ی اسکرین‌شات‌های فعلی با یه baseline — وجود داره.

نصب ProofShot ساده‌ست: با npm install -g proofshot نصب می‌شه و بعد proofshot install به‌صورت خودکار ایجنت‌های نصب‌شده روی سیستم (Claude Code، Cursor، Codex، Gemini CLI، Windsurf و...) رو تشخیص می‌ده و skill مربوطه رو نصب می‌کنه. skill‌ها در سطح کاربر نصب می‌شن، نه پروژه — پس یه بار نصب برای همه‌ی پروژه‌ها کافیه.

ProofShot تشخیص خطا رو هم از سرور لاگ‌ها به‌صورت خودکار انجام می‌ده و بیش از ۱۰ زبان رو پشتیبانی می‌کنه: از JavaScript و Python گرفته تا Ruby، Go، Java، Rust، PHP، Elixir و C#. هیچ وابستگی به cloud یا vendor خاصی نداره.

نکات کلیدی:

• ایجنت‌های AI کدنویسی نمی‌تونن نتیجه‌ی کارشون رو ببینن — ProofShot این مشکل رو حل می‌کنه
• workflow سه‌مرحله‌ای: start / test / stop
• خروجی شامل ویدیو، اسکرین‌شات، گزارش Markdown و viewer تعاملیه
• با Claude Code، Cursor، Codex، Gemini CLI، Windsurf و GitHub Copilot کار می‌کنه
• دستور proofshot pr artifacts رو مستقیم روی GitHub PR آپلود می‌کنه
• proofshot diff برای visual regression testing
• تشخیص خطا از سرور لاگ در بیش از ۱۰ زبان برنامه‌نویسی
• اوپن‌سورس، بدون نیاز به cloud، MIT license