ralph-starter 0.0.1

package/README.md

@@ -0,0 +1,35 @@
+# ralph-starter
+
+> AI-powered project scaffolder for Claude Code autonomous loops. From idea to running loop in one conversation.
+
+## Installation
+
+```bash
+npm install -g ralph-starter
+# or
+npx ralph-starter
+```
+
+## Features (Coming Soon)
+
+- **`ralph-starter init`** - AI chat to define your project, suggests tech stack, generates all Ralph files
+- **`ralph-starter new --template <name>`** - Create from templates (nextjs-saas, fastapi-ml, etc.)
+- **`ralph-starter skill add <name>`** - Install skills from marketplace
+- **`ralph-starter run [--docker]`** - Execute Claude Code loop with beautiful TUI
+- **`ralph-starter docs init`** - Setup Docusaurus/VitePress documentation
+- **`ralph-starter feature "<name>"`** - Create feature branch + spec + auto-PR
+
+## What Makes This Different
+
+Unlike other Claude Code loop tools, ralph-starter provides:
+
+1. **AI-assisted ideation** - Help figure out WHAT to build through conversation
+2. **Zero-to-loop experience** - Chat → specs → running loop in minutes
+3. **Template gallery** - Pre-built starters for common project types
+4. **Skill marketplace** - Discover and install community skills
+5. **Auto-documentation** - Generate Docusaurus/VitePress docs
+6. **Docker execution** - Sandboxed, safe autonomous coding
+
+## License
+
+MIT

package/dist/cli.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+
+console.log(`
+  ╭─────────────────────────────────────────────────────────────╮
+  │                                                             │
+  │   🚀 ralph-starter v0.0.1                                   │
+  │                                                             │
+  │   AI-powered project scaffolder for Claude Code loops       │
+  │   From idea to running loop in one conversation             │
+  │                                                             │
+  │   Coming soon:                                              │
+  │     • ralph-starter init    - AI chat to define project     │
+  │     • ralph-starter new     - Create from template          │
+  │     • ralph-starter skill   - Install skills                │
+  │     • ralph-starter run     - Execute the loop              │
+  │                                                             │
+  │   GitHub: https://github.com/rubenmarcus/ralph-starter      │
+  │                                                             │
+  ╰─────────────────────────────────────────────────────────────╯
+`);

package/dist/index.js

@@ -0,0 +1,3 @@
+// ralph-starter - AI-powered project scaffolder for Claude Code loops
+export const version = '0.0.1';
+export const name = 'ralph-starter';

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "ralph-starter",
+  "version": "0.0.1",
+  "description": "AI-powered project scaffolder for Claude Code autonomous loops. From idea to running loop in one conversation.",
+  "main": "dist/index.js",
+  "bin": {
+    "ralph-starter": "dist/cli.js"
+  },
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/cli.js",
+    "test": "vitest"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "ai",
+    "scaffolding",
+    "project-generator",
+    "autonomous",
+    "coding",
+    "ralph",
+    "cli"
+  ],
+  "author": "Ruben Marcus <ruben@rubenmarcus.dev>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rubenmarcus/ralph-starter"
+  },
+  "homepage": "https://github.com/rubenmarcus/ralph-starter#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}