just-ralph-it 0.1.0

Easily define your own software project idea and then build entirely by just clicking a button.

JRI (i.e. Just Ralph It, a.k.a. Ralfealo)

Getting started

Prerequisites

• uv
• Python 3.13 or newer

Installation

uv tool install just-ralph-it

Authentication

You can authenticate with an API key or reuse an existing ChatGPT Codex subscription.

To use an API key:

# Use OpenAI
export JRI_LLM_API_KEY=...

# Or use any OpenAI-compatible provider
export JRI_LLM_PROVIDER=https://provider.example/v1
export JRI_LLM_API_KEY=...

You can also use a .env file or CLI arguments.

To use a ChatGPT subscription, configure Codex to store credentials in a file:

# ~/.codex/config.toml
cli_auth_credentials_store = "file"

Then run:

# Log in with ChatGPT
codex login

# Configure JRI to reuse the Codex login
export JRI_LLM_PROVIDER=openai-codex

Usage

# Create a new directory for your project
# or just move to an existing one
mkdir /path/to/your-project
cd /path/to/your-project

# Run the TUI
# This will ask for the necessary environment variables
# Once that's ready, it will also set the .jri/ directory up
jri

# See all available options
jri --help

# Visualize the notes graph
jri view

Uninstalling

# Uninstall JRI and its dependencies
uv tool uninstall just-ralph-it

# Remove JRI from a repo
cd /path/to/your-project/.jri
rm -fr .jri/