@alwaysmeticulous/recorder-plugin

Meticulous SDK

The official SDK for Meticulous - automated end-to-end testing that eliminates test maintenance.

What is Meticulous?

Meticulous automatically creates and maintains a comprehensive test suite for your web application by recording real user interactions. When you open a pull request, Meticulous replays these user sessions against both the old and new versions of your app, identifying visual and functional differences.

Key Benefits

• Zero maintenance tests - Tests evolve automatically as your app changes
• Unprecedented coverage - Scale to thousands of tests without writing code
• Catch regressions early - Detect breaking changes before they reach production
• Record real user flows - Tests reflect actual usage patterns, not assumptions

Getting Started

Using Meticulous with AI coding agents? For agent skills and agent CLI docs, see alwaysmeticulous/skills.

Install the CLI:

npm install --save-dev @alwaysmeticulous/cli

Record a session:

npx @alwaysmeticulous/cli record --apiToken="<API_TOKEN>"

For complete setup instructions, see the Meticulous documentation.

Packages

This monorepo contains the following packages. Each package has its own detailed README with additional documentation:

• @alwaysmeticulous/cli - CLI tool for running Meticulous tests (docs)
• @alwaysmeticulous/recorder-loader - Session recorder for capturing user interactions
• @alwaysmeticulous/sdk-bundles-api - Core SDK bundle APIs
• Additional packages - Supporting libraries for replay orchestration, API clients, and more

Documentation

• Full Documentation
• Onboarding Guide
• GitHub Issues

Development

This repository is a public mirror. The code is published from an internal repository — pull requests and releases are managed there, not here. The repo uses pnpm workspaces for monorepo management; run pnpm install then pnpm build to build all packages.

Support

• Documentation: app.meticulous.ai/docs
• Issues: GitHub Issues