Ralphie
Turn a GitHub issue queue into reviewed pull requests with a coding-agent harness.
Ralphie is an opinionated CLI that reads open GitHub issues, asks a headless coding-agent harness (Claude Code first) for schema-validated decisions, and implements each agent-ready issue. Agents handle reasoning and code changes; Ralphie keeps Git, GitHub, run state, diagnostics, and safety checks deterministic.
Ralphie runs as a local web server with a browser UI, or headlessly through
ralphie drain for scripts and CI. Install the latest release with
bun add -g @beremaran/ralphie, or try it with bunx @beremaran/ralphie --version. The getting-started guide walks
ralphie init, tracking a repository, the first server run, and the headless
path; read the safety model before enabling mutations.
Documentation
Start with the documentation index. Audience entry points:
- New user: Getting started, then Safety.
- Operator: Workflows, CLI reference, and Operations and recovery.
- Contributor: Development and Architecture.
- Release maintainer: Publishing.
License
Ralphie is MIT licensed.