momentic-test
Create, run, and maintain end-to-end tests using AI-driven browser automation with YAML serialization.
- Tests are ordered lists of structured steps executed with Playwright and CDP, supporting interactive clicks/types, multimodal assertions, and goal-based AI actions
- Step metadata (selectors, XPaths, coordinates) is cached by git branch to avoid repeated AI calls; cache can be disabled or refreshed per step when targeting dynamic elements
- Tests and reusable modules serialize to disk as
*.test.yamland*.module.yamlfiles (v2 format supports direct YAML editing; v1 requires MCP CLI) - Test context persists across steps via
envvariables; JavaScript steps run in either NODE (with Momentic helpers, database access, OTP/email) or BROWSER (with DOM access) - Smart waiting up to 5 seconds settles page state before targeting; project defaults in
momentic.config.yamlcan be overridden per test for browser type, viewport, auth, proxy, and timeouts
Momentic model
Momentic turns structured natural language into browser automation using forked Playwright, CDP, and custom agents. Interactive steps resolve natural-language targets, assertions can use multimodal models, and AI actions can complete broader goals.
Project files and formats
Tests use *.test.yaml; reusable modules use *.module.yaml. Test IDs live in
the test file's id field. Check momentic.config.yaml and test-level metadata
before assuming project defaults apply.
fileType: momentic/test/v2 and fileType: momentic/module/v2 identify v2
files. Treat missing or different fileType as deprecated v1. Never edit v1
YAML directly; persist changes through momentic_test_splice_steps.