ripplo 0.0.6 → 0.0.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +23 -13
- package/dist/index.js +252 -321
- package/dist/mcp/index.js +125 -108
- package/package.json +17 -5
package/README.md
CHANGED
|
@@ -2,30 +2,40 @@
|
|
|
2
2
|
|
|
3
3
|
CLI for [Ripplo](https://ripplo.ai) — AI-powered end-to-end testing.
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## Quick Start
|
|
6
|
+
|
|
7
|
+
Run this in your project directory:
|
|
6
8
|
|
|
7
9
|
```sh
|
|
8
|
-
|
|
10
|
+
npx ripplo
|
|
9
11
|
```
|
|
10
12
|
|
|
11
|
-
|
|
13
|
+
This will:
|
|
12
14
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
15
|
+
- Authenticate and connect your project
|
|
16
|
+
- Auto-install the MCP server for your coding agent
|
|
17
|
+
- Scaffold a `.ripplo/` directory for your test graph
|
|
18
|
+
- Start dev mode — build locally, deploy to cloud when ready
|
|
19
|
+
|
|
20
|
+
Your agent will handle the rest — no manual test writing required.
|
|
21
|
+
|
|
22
|
+
Then paste `/mcp` into Claude Code (or your coding agent) to activate the Ripplo MCP.
|
|
23
|
+
|
|
24
|
+
## How It Works
|
|
25
|
+
|
|
26
|
+
**Finding your key user flows** — Your agent reads through your app to find the important things users do — signing up, logging in, creating content. It maps these into a test graph so every flow can be tested independently.
|
|
27
|
+
|
|
28
|
+
**Every test gets a clean slate** — Each test defines its own preconditions like a fresh user, sample data, and the right permissions. No shared data or ordering dependencies. Scale to thousands of tests without flakes.
|
|
29
|
+
|
|
30
|
+
**Dev mode to cloud** — Your agent builds and runs tests locally as you develop. When you merge, workflows sync from your repo and run in the cloud against your deployed environment.
|
|
16
31
|
|
|
17
|
-
|
|
32
|
+
**Secure by default** — Every request to your app is cryptographically signed so you know it's from Ripplo. Test endpoints are gated behind an environment variable — they're never exposed in production.
|
|
18
33
|
|
|
19
34
|
## Commands
|
|
20
35
|
|
|
21
36
|
| Command | Description |
|
|
22
37
|
| ---------------- | ---------------------------------------------------- |
|
|
23
|
-
| `
|
|
24
|
-
| `init` | Create a new project and start dev mode |
|
|
25
|
-
| `run` | Execute a workflow spec via Playwright |
|
|
26
|
-
| `dev` | Watch files and run workflows from the UI |
|
|
27
|
-
| `agent-test` | Run an autonomous agent test locally |
|
|
28
|
-
| `setup-mcp` | Configure MCP server in `.mcp.json` |
|
|
38
|
+
| `ripplo` | Launch the interactive dashboard |
|
|
29
39
|
| `generate-types` | Generate Zod schemas + TS types for precondition API |
|
|
30
40
|
|
|
31
41
|
Learn more at [ripplo.ai](https://ripplo.ai).
|