Muraqib, free nightly QA that lets Claude open a fix PR when tests fail

Muraqib, a free nightly QA system for solo developers, runs Playwright tests against live apps and lets Claude open fix PRs when tests fail, with a weekly digest email. The open-source project, released on GitHub, uses GitHub Actions, Claude Code Action, and Resend, and defaults to manual review unless auto-merge is enabled with a guard. It offers a self-hosted alternative to Octomind's paid service, which stopped taking new customers in April 2026.

Arabic: مُراقِب "the guardian, the watchful one" Muraqib is a nightly QA system built for one-person software teams. It runs Playwright tests against your live app every night, lets Claude fix failing tests automatically, and sends you one weekly summary email. You only hear about it on Monday morning. Solo founders can't afford a QA team. But silent regressions a broken signup flow, a payment page that 404s, a broken PDF export are invisible until a customer complains. Muraqib watches while you sleep. Nightly 2am → Playwright runs all tests against production ↓ if tests fail Claude reads the error, diagnoses it, opens a PR with the fix ↓ if fix passes CI PR waits for manual review by default, see "Auto-merge" below ↓ always Weekly digest email every Monday with pass/fail history Playwright : browser automation + test runner GitHub Actions : nightly cron, dispatches the Claude fix workflow on failure Claude Code Action : reads failing test output, writes the fix, opens a PR Resend : failure/weekly digest email | Path | What it does | |---|---| tests/ | Playwright test specs you write these for your app | tasks/ | Handwritten automation tasks | tasks/registry.ts | Maps task names to handlers, no runtime AI, zero token cost | task-runner.ts | CLI: npm run task -- <name --flags | lib/selfHeal.ts | Reference implementation of the Claude fix-prompt builder | .github/workflows/ | The nightly runner + the Claude auto-fix workflow, already wired | - Use this repo as a template or clone it into your own project. - Edit muraqib.config.ts : set baseUrl , projectName , flows , and alerting.emailTo / emailFrom . - Add secrets in your repo settings: ANTHROPIC API KEY , RESEND API KEY . - Write your Playwright specs in tests/ , matching the file name in each flow. - Leave claudeIntegration.autoMerge at its default false until you've read the "Auto-merge" section below. Default is off. Claude opens a PR, CI runs against it, and it waits for you to review and merge, the same as any other PR. This is deliberate: CI passing means the fix didn't break the tests it can see, not that the fix is correct. If you turn autoMerge on, two independent things keep it from touching payment/auth/migration/secrets code: - The Claude fix prompt is instructed to leave those for manual review regardless of the setting. That is a text instruction a model reads. .github/workflows/auto-merge-guard.yml checks the actual changed files on any PR with auto-merge enabled and force-disables it if a sensitive path matches. That is code, not a prompt. Turning autoMerge on requires one manual setup step: add "Muraqib Auto-Merge Guard / guard" as a required status check in your repo's branch protection rules for main . Without that, the guard still runs and will disable auto-merge and comment if it catches something, but GitHub's native auto-merge can complete before the guard job does. A required status check is what makes GitHub wait for it. Auto-merge without both the guard and that setting is not a safety net, it's just skipping review. This repo has that setting configured on main as of 2026-08-29; if you fork or clone this for your own project, you need to add it yourself. Octomind offered a similar idea nightly AI-assisted QA as a paid, hosted product starting around $89/month, and stopped taking new customers in April 2026. This project is not a hosted replacement for it, it is a different shape entirely: you clone it, it runs in your own GitHub Actions and your own Claude subscription, and there is no monthly bill because there is no service to bill for. The tradeoff is honest too, you set it up yourself a config file, two secrets, your own test specs , instead of signing up and getting a dashboard. If you want a hosted, zero-setup product with support, this is not that. If you want the same core idea for $0 and are fine reading a README, this repo is free and MIT licensed, and its full defect history below is public, not a claim. Tasks are always handwritten : no runtime AI generates or executes tasks. Writing a new handler is one-time Claude work. Running it costs 0 tokens. You get one email per week , plus one on the night something actually breaks. Not one per failed test. Signal, not noise. Test failure text is data, not instructions : the Claude fix prompt explicitly labels error output as untrusted, and never lets it decide the auto-merge outcome. Auto-merge is opt-in and scoped : off by default, and even when on, payment/auth/migration/secrets changes always wait for a human. MIT License.