ralphie 1.0.0 → 1.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 (18) hide show
  1. package/README.md +79 -22
  2. package/dist/cli.js +2982 -2701
  3. package/package.json +12 -4
  4. package/skills/SKILLS.md +69 -0
  5. package/skills/ralphie-iterate/SKILL.md +264 -751
  6. package/skills/ralphie-spec/SKILL.md +359 -0
  7. package/skills/review-spec/SKILL.md +367 -218
  8. package/templates/.claude/ralphie.md +2 -2
  9. package/templates/RALPHIE.md +87 -59
  10. package/templates/specs/active/.gitkeep +0 -0
  11. package/templates/specs/completed/.gitkeep +0 -0
  12. package/templates/specs/lessons.md +18 -0
  13. package/templates/specs/templates/bugfix.md +66 -0
  14. package/templates/specs/templates/feature.md +56 -0
  15. package/templates/specs/templates/refactor.md +80 -0
  16. package/skills/create-spec/SKILL.md +0 -222
  17. package/templates/.claude/skills/create-spec/SKILL.md +0 -222
  18. package/templates/.claude/skills/ralphie-iterate/SKILL.md +0 -959
package/package.json CHANGED
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "name": "ralphie",
3
- "version": "1.0.0",
3
+ "version": "1.1.0",
4
4
  "description": "Autonomous AI coding loops - let AI build your project task by task",
5
5
  "author": "Skylar Barrera",
6
6
  "license": "MIT",
7
7
  "repository": {
8
8
  "type": "git",
9
- "url": "https://github.com/skylarbarrera/ralphie.git"
9
+ "url": "git+https://github.com/skylarbarrera/ralphie.git"
10
10
  },
11
11
  "bugs": {
12
12
  "url": "https://github.com/skylarbarrera/ralphie/issues"
@@ -17,6 +17,7 @@
17
17
  "automation",
18
18
  "claude",
19
19
  "codex",
20
+ "opencode",
20
21
  "coding-assistant",
21
22
  "autonomous",
22
23
  "loop"
@@ -24,7 +25,7 @@
24
25
  "type": "module",
25
26
  "main": "dist/cli.js",
26
27
  "bin": {
27
- "ralphie": "./bin/ralphie"
28
+ "ralphie": "bin/ralphie"
28
29
  },
29
30
  "files": [
30
31
  "bin",
@@ -36,7 +37,7 @@
36
37
  "node": ">=18.0.0"
37
38
  },
38
39
  "scripts": {
39
- "build": "bun build src/cli.tsx --outdir dist --target node --external '@anthropic-ai/claude-agent-sdk' --external '@openai/codex-sdk' --external 'ink' --external 'ink-spinner' --external '@inkjs/ui' --external 'react' --external 'commander' --external 'js-yaml'",
40
+ "build": "bun build src/cli.tsx --outdir dist --target node --external '@anthropic-ai/claude-agent-sdk' --external '@openai/codex-sdk' --external '@opencode-ai/sdk' --external 'ink' --external 'ink-spinner' --external '@inkjs/ui' --external 'react' --external 'commander' --external 'js-yaml' --external 'dotenv'",
40
41
  "prepublishOnly": "npm run build",
41
42
  "ralphie": "bun src/cli.tsx run",
42
43
  "test": "bun x vitest run",
@@ -48,8 +49,10 @@
48
49
  "@anthropic-ai/claude-agent-sdk": "0.2.7",
49
50
  "@inkjs/ui": "^2.0.0",
50
51
  "@openai/codex-sdk": "0.86.0",
52
+ "@opencode-ai/sdk": "^1.1.25",
51
53
  "@types/js-yaml": "^4.0.9",
52
54
  "commander": "^11.1.0",
55
+ "dotenv": "^17.2.3",
53
56
  "ink": "^5.0.1",
54
57
  "ink-spinner": "^5.0.0",
55
58
  "js-yaml": "^4.1.0",
@@ -63,5 +66,10 @@
63
66
  "ink-testing-library": "^4.0.0",
64
67
  "typescript": "^5.3.0",
65
68
  "vitest": "^1.2.0"
69
+ },
70
+ "directories": {
71
+ "doc": "docs",
72
+ "example": "examples",
73
+ "test": "tests"
66
74
  }
67
75
  }
package/skills/SKILLS.md ADDED
@@ -0,0 +1,69 @@
1
+ ---
2
+ name: ralphie-skills
3
+ description: Ralphie core skills - spec generation, validation, and iteration
4
+ license: MIT
5
+ ---
6
+
7
+ # Ralphie Skills
8
+
9
+ ## Available Skills
10
+
11
+ ### Spec Generation
12
+
13
+ #### ralphie-spec
14
+ Generate project specifications through structured user interviews.
15
+ - **Install**: `npx add-skill skylarbarrera/ralphie --skill ralphie-spec`
16
+ - **Use**: Run `/ralphie-spec` in Claude Code when user is present
17
+
18
+ #### review-spec
19
+ Validate spec format and content quality.
20
+ - **Install**: `npx add-skill skylarbarrera/ralphie --skill review-spec`
21
+ - **Use**: Run `/review-spec` after generating a spec for quality review
22
+
23
+ ### Project Management
24
+
25
+ #### verify
26
+ Pre-commit verification skill that auto-detects project tooling and runs appropriate checks.
27
+ - **Install**: `npx add-skill skylarbarrera/ralphie --skill verify`
28
+ - **Use**: During ralphie iterations to validate code before committing
29
+
30
+ #### ralphie-iterate
31
+ Execute autonomous coding iterations following Ralphie protocol.
32
+ - **Install**: `npx add-skill skylarbarrera/ralphie --skill ralphie-iterate`
33
+ - **Use**: To implement tasks from spec files in `specs/active/`
34
+
35
+ ## Installation
36
+
37
+ ```bash
38
+ # Install all Ralphie skills
39
+ npx add-skill skylarbarrera/ralphie
40
+
41
+ # Install specific skill
42
+ npx add-skill skylarbarrera/ralphie --skill ralphie-spec
43
+ ```
44
+
45
+ ## Usage
46
+
47
+ ### CLI Usage
48
+ ```bash
49
+ # Autonomous spec generation via CLI:
50
+ ralphie spec "Build a REST API for user management"
51
+
52
+ # Run implementation iterations:
53
+ ralphie run --all
54
+ ```
55
+
56
+ ### Direct Skill Invocation
57
+ ```bash
58
+ # In Claude Code, Codex, or OpenCode:
59
+ /ralphie-spec "Build a REST API" # Interactive with user
60
+ /review-spec # Review existing spec
61
+ ```
62
+
63
+ ## Cross-Platform Support
64
+
65
+ All skills are designed to be:
66
+ - **Self-contained** - No local CLI dependencies required
67
+ - **Universal** - Work across Claude Code, Codex, OpenCode
68
+ - **Standard** - Use only common tools (Read, Write, Edit, Glob, Grep, Bash)
69
+ - **Distributable** - Installable via `npx add-skill`