Next generation AI First - Browser Testing platform

Low Tokens consumption
Built for AI Agents - Claude/Codex

Built for developers, QA or both
Control entire QA via MCP

Bonus Chrome Extension & MCP...
...with Recorder, AI Test Writer

★ Automate: Automate browser testing, using claude, codex - with skills, mcp, test runners & dashboard.

★ Chrome Extension: Capture browser actions, send to AI to write tests, upload, self heal.

✴︎ Test Management: Organize test suites and test cases, run them on demand or on a schedule.

✴︎ Test Runners: Playwright-powered execution with full run history.

✴︎ Notifications: Get notified when suites finish or fail.

✴︎ User Management: Roles, permissions, and per-user IAM.

✴︎ MCP Server: Low token consumption over MCP layer, control all aspects of tests cases, code.

✴︎ Agent Plugins: Claude/Codex plugins included - zero-code test code management.

Feature Matrix

Feature	MCP	Dashboard	CI Webhook
Suites: list / get / create / update / delete / edit	✅	✅	-
Tests: list / get / create / update / update code / delete / bulk-delete	✅	✅	-
Tests: bulk-create	✅	-	-
Runs: get / trigger / cancel / delete / logs	✅	✅	-
Runs: status	✅	✅	✅
Screenshots: list / get	✅	✅	-
Recorder: chrome://extension events	✅	-	-
Login / Register / Logout / Password reset	-	✅	-
Profile: update name / password	-	✅	-
Dashboard analytics (stats, recent runs)	-	✅	-
Suite webhook token: regenerate	-	✅	-
Suite members: list / add / update / remove privileges	✅	✅	-
Test code-version: restore	-	✅	-
Admin: manage users (create, list, role, delete, reset password)	-	✅	-

AI Usage

claude /plugin marketplace add https://github.com/rakutentech/sorify.git
codex plugin marketplace add https://github.com/rakutentech/sorify.git

SKILL 1 - Sorify MCP

╰─$ cat ~/.sorify
SORIFY_URL=http://localhost:8000/sorify
SORIFY_USERNAME=admin@sorify.local
SORIFY_PASSWORD=changeme

/sorify:gateway Create a test suite called "Awesome App"
/sorify:gateway List latest failing tests

/sorify:gateway Create new test suite. Get requirements from JIRA/GHE/Excel. Write using /sorify:generate
/sorify:gateway Update the test suite http://localhost:8000/sorify/suites/{id} by adding retry twice

SKILL 2 - Inbuilt QA Skills

# Tests from source code (git)
/sorify:generate Scan my code and generate tests for <github.com/your/repo>

# Tests from source code (path)
/sorify:generate Scan my code and generate tests for </path/to/your/source>

# Tests from url (remote)
/sorify:generate Crawl site and generate tests for https://rakuten.co.jp

# Tests from url (local)
/sorify:generate Crawl site and generate tests for http://localhost:3000/my-awesome-app

# Tests from requirements
/sorify:generate Read requirements here <link to docs> <path to docs> <raw paste>
<you got the idea...>

OR SKILL BYO - Bring your own QA Skills

/my:qa:skill Create detailed tests <...>
...then /sorify:gateway once done - upload, run and invetigate failed tests

SKILL 3 - Record, Capture, Generate, upload (Chrome extension)

Generate tests from a real recorded session instead of DOM exploration — chrome-mcp-playwright sorify-recorder-mcp

No 1. Load the extension

chrome://extensions/ → enable "Developer mode" → "Load unpacked" → select extension/ folder

No 2. Install the mcp

curl -fsSL https://raw.githubusercontent.com/rakutentech/sorify/master/mcp/install-mcp.sh | sh

we don't have npx, sorry

No 3. Recorder start

Sorify recorder should start automatically, when you launch claude/codex

You can check using /mcp → plugin:sorify:sorify-recorder

If not, then you can using ~/.sorify-bin/sorify-recorder-mcp.

No 4. Click the extension icon → Connect → Start recording

Perform the clicks/inputs you want turned into a test, then Stop recording.

Tip: to check the port lsof -nP -iTCP:7420 -sTCP:LISTEN

No 5. Generate tests

/sorify:recording latest

AI Healing

/sorify:gateway why my test is failing <name of test>
/sorify:gateway why my test is failing <or-link-to-test>

Quick Start

Development (local)

Option 1 - Simple

# Update: APP_KEY, DB_PASSWORD, MYSQL_ROOT_PASSWORD
cp .env.example .env

composer setup
php artisan dev

Option 2 - Detailed

npm run dev
php artisan serve
php artisan queue:work --queue=sorify,default
php artisan schedule:work

Self Hosting

cp .env.docker.example .env.docker
# Update: APP_KEY, DB_PASSWORD, MYSQL_ROOT_PASSWORD
# Change: APP_ENV=prod for prod ready
docker compose --env-file .env.docker up

Verify

http://localhost:8000/sorify

• User: admin@sorify.local
• Password: changeme

Notes for users

• Fully self hosted, no telemetry
• What your AI does in yolo mode is your responsibility
• Files and folders on your system, that this system creates/requires
  • ~/.sorify: your credentials
  • ~/.sorify-bin/: chrome extension mcp
  • ~/.sorify-recordings/: chrome extension mcp's events recordings

---

Owners

MarikoKikugawa	asghar-ahmed	HiromichiHagiwara
kevincobain2000	pulkit-kathuria	chetra-tep	chetratep

Contribution

• Raise an issue or PR to master

License

Licensed under the Apache License, Version 2.0.

The Chrome extension in extension/ is licensed separately under the BSD 3-Clause License, which prohibits publishing it (or a derivative) under the "Sorify Recorder" name without permission. See extension/README.md for details.

CHANGE LOG

• v1 - Intial Release
• v1.1 - Batteries added on user management, mcp enhancement
• v1.2 - Chrome Extension to record and write playwright tests
• v1.3 - Skills updated, MS Teams notifications links to a screenshot, dashboard has admin editable msg
• v1.4 - Manage users from MCP.
• v1.5 - i18n support for English and Japanese for now.
• v1.6 - i18n support for Malay, Simplified Chinese. Extension captures file uploads, iframes, tabs, network.
• v1.7 - oAuth login, with Avatar.