Just Ralph It (a.k.a. Ralfealo)

Overview

Just Ralph It (JRI) is currently an agent harness to think ideas through and write specs that match what you actually mean. In the future, it will not just write specs, but also autonomously ship and maintain the entire software.

Feature Roadmap

• Terminal UI
• Requirements gathering interview
  • Exploration
    • Local shell commands
    • Local files, including images
    • Web search
    • Public URLs, including YouTube videos
  • Note taking
  • Topic-based context management
• Automated implementation (inspired on the SDLC and the Ralph technique)
  • Requirements analysis
  • System design
  • Development
  • Quality assurance
  • Deployment
  • Maintenance
• Remote execution
• Web UI
  • Notes graph visualization
• Hosted platform

Getting Started

0. Prerequisites

• Python >=3.13 or uv
• API key from Vercel AI Gateway (the default), any other OpenAI-compatible LLM inference provider, or a ChatGPT subscription
• Git >=2.x.x

1. Installation

uv tool install just-ralph-it
# Alternative command:
pip install just-ralph-it

2. Setup

Move to a project directory and set it up:

mkdir ./my-project
cd ./my-project
jri init

That creates .jri/settings.yaml. Open it and follow its comments.

3. Usage

# Run the TUI to start a chat session:
jri chat

# See all available commands:
jri --help

Upgrading

uv tool upgrade just-ralph-it
# Alternative command:
pip install --upgrade just-ralph-it

Uninstalling

uv tool uninstall just-ralph-it
# Alternative command:
pip uninstall just-ralph-it

# Remove JRI from the project:
rm -fr /path/to/your-project/.jri