runhuman 0.1.0

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.
Files changed (3) hide show
  1. package/README.md +97 -0
  2. package/index.js +53 -0
  3. package/package.json +37 -0
package/README.md ADDED
@@ -0,0 +1,97 @@
1
+ # runhuman
2
+
3
+ [![npm version](https://img.shields.io/npm/v/runhuman.svg)](https://www.npmjs.com/package/runhuman)
4
+ [![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)
5
+
6
+ > **🚧 Coming Soon:** The Runhuman CLI is currently under development.
7
+
8
+ ## What is Runhuman?
9
+
10
+ Runhuman is an AI-orchestrated human QA testing service. Get real human testing of your web applications on-demand, with structured results extracted automatically.
11
+
12
+ **Perfect for:**
13
+ - AI coding agents that need human verification
14
+ - CI/CD pipelines with human QA gates
15
+ - Visual/UX testing requiring real human judgment
16
+ - On-demand QA without hiring/managing teams
17
+
18
+ ## Available Now: MCP Server for AI Agents
19
+
20
+ If you're using AI agents (Claude, GPT, etc.), use our MCP server package:
21
+
22
+ ```bash
23
+ # Install globally
24
+ npm install -g @runhuman/mcp
25
+
26
+ # Or use with npx
27
+ npx @runhuman/mcp --api-key=qa_live_xxxxxxxxxxxxx
28
+ ```
29
+
30
+ ### Claude Desktop Setup
31
+
32
+ Add to your Claude Desktop config:
33
+
34
+ ```json
35
+ {
36
+ "mcpServers": {
37
+ "runhuman": {
38
+ "command": "npx",
39
+ "args": ["-y", "@runhuman/mcp", "--api-key=qa_live_xxxxxxxxxxxxx"]
40
+ }
41
+ }
42
+ }
43
+ ```
44
+
45
+ **Config locations:**
46
+ - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
47
+ - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
48
+
49
+ Get your API key at: [runhuman.com/dashboard](https://runhuman.com/dashboard)
50
+
51
+ ## Coming Soon: Full CLI
52
+
53
+ The full `runhuman` CLI will include commands like:
54
+
55
+ ```bash
56
+ # Create a test job
57
+ runhuman create --url https://myapp.com --description "Test checkout flow"
58
+
59
+ # List jobs
60
+ runhuman list
61
+
62
+ # Get job status
63
+ runhuman status <jobId>
64
+
65
+ # View results
66
+ runhuman results <jobId>
67
+
68
+ # And more...
69
+ ```
70
+
71
+ **Stay tuned!** We'll announce when the CLI is ready.
72
+
73
+ ## Learn More
74
+
75
+ - **Website:** [runhuman.com](https://runhuman.com)
76
+ - **Documentation:** [runhuman.com/docs](https://runhuman.com/docs)
77
+ - **MCP Server:** [@runhuman/mcp](https://www.npmjs.com/package/@runhuman/mcp)
78
+ - **GitHub:** [github.com/volter-ai/runhuman](https://github.com/volter-ai/runhuman)
79
+
80
+ ## Support
81
+
82
+ - **Email:** hey@runhuman.com
83
+ - **Issues:** [GitHub Issues](https://github.com/volter-ai/runhuman/issues)
84
+
85
+ ## How It Works
86
+
87
+ 1. **AI creates job** - Define test instructions and output schema
88
+ 2. **Job posted to testers** - Request goes to human tester pool
89
+ 3. **Human performs test** - Real person tests with video/screenshot recording
90
+ 4. **AI extracts data** - GPT-4o processes feedback into structured JSON
91
+ 5. **AI gets results** - Clean, typed data ready for automation
92
+
93
+ **Pricing:** Pay-per-second ($0.0018/sec of tester time). No monthly fees, no minimums.
94
+
95
+ ---
96
+
97
+ **Built with ❤️ by the [Volter AI](https://volter.ai) team**
package/index.js ADDED
@@ -0,0 +1,53 @@
1
+ #!/usr/bin/env node
2
+
3
+ /**
4
+ * Runhuman CLI - Coming Soon
5
+ *
6
+ * This is a placeholder package that reserves the `runhuman` npm package name.
7
+ * The full CLI is currently in development.
8
+ *
9
+ * For now, if you're looking to use Runhuman with AI agents (Claude, GPT, etc.),
10
+ * please use the MCP server package instead:
11
+ *
12
+ * npm install -g @runhuman/mcp
13
+ *
14
+ * Or use with npx:
15
+ *
16
+ * npx @runhuman/mcp --api-key=qa_live_xxxxx
17
+ *
18
+ * Documentation: https://runhuman.com
19
+ */
20
+
21
+ console.log(`
22
+ ╔═══════════════════════════════════════════════════════════════════════════╗
23
+ ║ ║
24
+ ║ 🚧 Runhuman CLI - Coming Soon 🚧 ║
25
+ ║ ║
26
+ ╚═══════════════════════════════════════════════════════════════════════════╝
27
+
28
+ The Runhuman CLI is currently under development.
29
+
30
+ For AI agents (Claude, GPT, etc.), use the MCP server:
31
+
32
+ 📦 Install: npm install -g @runhuman/mcp
33
+ 🚀 Run: npx @runhuman/mcp --api-key=qa_live_xxxxx
34
+
35
+ For Claude Desktop, add to your config:
36
+ {
37
+ "mcpServers": {
38
+ "runhuman": {
39
+ "command": "npx",
40
+ "args": ["-y", "@runhuman/mcp", "--api-key=YOUR_KEY"]
41
+ }
42
+ }
43
+ }
44
+
45
+ 📚 Documentation: https://runhuman.com
46
+ 🔑 Get API Key: https://runhuman.com/dashboard
47
+ 💬 Support: hey@runhuman.com
48
+
49
+ The full CLI with commands like 'runhuman create', 'runhuman list', etc.
50
+ will be available soon!
51
+ `);
52
+
53
+ process.exit(0);
package/package.json ADDED
@@ -0,0 +1,37 @@
1
+ {
2
+ "name": "runhuman",
3
+ "version": "0.1.0",
4
+ "description": "CLI for Runhuman - AI-orchestrated human QA testing (Coming Soon)",
5
+ "main": "index.js",
6
+ "type": "module",
7
+ "bin": {
8
+ "runhuman": "index.js"
9
+ },
10
+ "files": [
11
+ "index.js",
12
+ "README.md"
13
+ ],
14
+ "keywords": [
15
+ "runhuman",
16
+ "qa",
17
+ "testing",
18
+ "human-in-the-loop",
19
+ "cli",
20
+ "qa-testing",
21
+ "manual-testing"
22
+ ],
23
+ "author": "Runhuman <hey@runhuman.com>",
24
+ "repository": {
25
+ "type": "git",
26
+ "url": "git+https://github.com/volter-ai/runhuman.git",
27
+ "directory": "packages/cli"
28
+ },
29
+ "homepage": "https://runhuman.com",
30
+ "bugs": {
31
+ "url": "https://github.com/volter-ai/runhuman/issues"
32
+ },
33
+ "license": "ISC",
34
+ "engines": {
35
+ "node": ">=18.0.0"
36
+ }
37
+ }