humanize

Humanize

Current Version: 1.10.4

Derived from the GAAC (GitHub-as-a-Context) project.

What is RLCR?

RLCR stands for Ralph-Loop with Codex Review. It was inspired by the official ralph-loop plugin, enhanced with a series of optimizations and independent Codex review capabilities.

The name can also be interpreted as Reinforcement Learning with Code Review - reflecting the iterative improvement cycle where AI-generated code is continuously refined through external review feedback.

A Claude Code plugin that provides iterative development with Codex review. Humanize creates a feedback loop where Claude implements your plan while Codex independently reviews the work, ensuring quality through continuous refinement.

Core Philosophy

Iteration over Perfection: Instead of expecting perfect output in one shot, Humanize leverages an iterative feedback loop where:

• Claude implements your plan
• Codex independently reviews progress
• Issues are caught and addressed early
• Work continues until all acceptance criteria are met

This approach provides:

• Independent review preventing blind spots
• Goal tracking to prevent drift
• Quality assurance through iteration
• Complete audit trail of development progress

Installation

Option 1: Install from Git Marketplace (Recommended)

Start Claude Code and run the following commands:

# Add the marketplace
/plugin marketplace add [email protected]:humania-org/humanize.git

# Install the plugin
/plugin install humanize@humania

Option 2: Local Development / Testing

If you have the plugin cloned locally:

# Start Claude Code with the plugin directory
claude --plugin-dir /path/to/humanize

Prerequisites

• codex - OpenAI Codex CLI (for review). Check with codex --version.

Environment Variables

Humanize supports the following environment variables for advanced configuration:

HUMANIZE_CODEX_BYPASS_SANDBOX

WARNING: This is a dangerous option that disables security protections. Use only if you understand the implications.

• Purpose: Controls whether Codex runs with sandbox protection
• Default: Not set (uses --full-auto with sandbox protection)
• Values:
  • true or 1: Bypasses Codex sandbox and approvals (uses --dangerously-bypass-approvals-and-sandbox)
  • Any other value or unset: Uses safe mode with sandbox

When to use this:

• Linux servers without landlock kernel support (where Codex sandbox fails)
• Automated CI/CD pipelines in trusted environments
• Development environments where you have full control

When NOT to use this:

• Public or shared development servers
• When reviewing untrusted code or pull requests
• Production systems
• Any environment where unauthorized system access could cause damage

Security implications:

• Codex will have unrestricted access to your filesystem
• Codex can execute arbitrary commands without approval prompts
• Review all code changes carefully when using this mode

Usage example:

# Export before starting Claude Code
export HUMANIZE_CODEX_BYPASS_SANDBOX=true

# Or set for a single session
HUMANIZE_CODEX_BYPASS_SANDBOX=true claude --plugin-dir /path/to/humanize

Usage

How It Works

flowchart LR
    Plan["Your Plan<br/>(plan.md)"] --> Claude["Claude Implements<br/>& Summarizes"]
    Claude --> Codex["Codex Reviews<br/>Summary"]
    Codex -->|Feedback Loop| Claude
    Codex -->|COMPLETE| Review["Code Review<br/>(codex review)"]
    Review -->|Issues Found| Claude
    Review -->|No Issues| Done((Done))

The loop has two phases:

1. Implementation Phase: Claude works, Codex reviews summaries until COMPLETE
2. Review Phase: codex review --base <branch> checks code quality with [P0-9] severity markers

Quick Start

1. Create a plan file or just write down your thoughts in <name/you/like/for/draft>.md and use /humanize:gen-plan

   /humanize:gen-plan --input <name/you/like/for/draft.md> --output <docs/my-feature-plan.md>
   

2. Run the loop:

   /humanize:start-rlcr-loop <docs/my-feature-plan.md>
   

3. Monitor progress in .humanize/rlcr/<timestamp>/ or you can use the monitor script:

   source ~/.claude/plugins/cache/humania/humanize/<LATEST.VERSION>/scripts/humanize.sh // Add this to your .bashrc or .zshrc
   humanize monitor [rlcr|pr] // Launch this from where you start claude to monitor RLCR loop or PR loop
   

4. Cancel if needed: /humanize:cancel-rlcr-loop

Commands