feat: universal CLI packaging with arbitrary tools and Windows support #38
+1,091
−134
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add a root package.json with a ralph bin and make the CLI run from cwd. Document local global install usage and clarify archiving behavior.
Ignore docs/plans to keep local plan drafts out of git status.
Add support for custom tool arguments and prompt file selection to Ralph CLI. This enables using arbitrary tool commands beyond amp/claude and selecting custom prompt templates. Changes: - Add `--tool-args <arg>` flag to pass extra arguments to the tool - Add `--prompt-file <path>` flag to specify custom prompt file - Remove tool validation in ralph.sh to allow custom commands - Add resolveEntrypointPath helper for global install path normalization - Add pathsAreEqual helper for cross-platform path comparison - Fix isEntrypoint detection for windows global installs - Update parseArgs to return toolArgs and promptFile - Update runLoop to use toolArgs and resolvedPromptFile - Add comprehensive tests for new CLI flags and path helpers Co-Authored-By: Claude <noreply@anthropic.com>
Add a help message that is displayed when the CLI is invoked with no arguments, or with -h/--help. This makes the tool more user-friendly and follows standard CLI conventions. Changes: - Add `getHelpText()` helper in ralph.js - Update ralph.js entrypoint to check for empty arguments or help flags - Update ralph.sh to support -h/--help and empty arguments - Add test case for getHelpText - Update existing CLI tests to pass arguments and avoid help message Co-Authored-By: Claude <noreply@anthropic.com>
Consolidate the CLI implementation into a single Node.js script. This simplifies maintenance and ensures consistent behavior across platforms. Updated documentation to reflect the removal of ralph.sh and the use of ralph.js as the primary entrypoint. Changes: - Delete ralph.sh - Update README.md with node execution instructions - Update AGENTS.md with node and global CLI commands - Remove jq and bash-specific requirements from prerequisites Co-Authored-By: Claude <noreply@anthropic.com>
alexx-ftw
changed the title
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
This PR transitions Ralph into a proper universal CLI package that can be installed globally and run from any directory. It migrates the core logic from Bash ("ralph.sh") to a cross-platform Node.js implementation ("ralph.js") and introduces flexible command-line arguments for advanced workflows.
Key Changes:
package.jsonwithbinmapping. Supportsnpm install -g ..ralph.shwith a normalizedralph.jsentrypoint, reducing dependencies (no longer requiresjqorbash).--tool <command>to allow any AI tool beyondampandclaude.--tool-args <arg>to pass flags directly to the underlying tool (e.g.,--printfor Claude Code).--prompt-file <path>to specify alternative instruction templates.node_modulespaths.getHelpText()triggered by-h,--help, or running without arguments.process.cwd()as the default base directory.Test Plan
node ralph.test.jsnpm install -g .ralph --help.ralph --tool echo --tool-args "hello world" 1.