---
title: "agentsys vs ralph-claude-code"
type: "comparison"
canonical_url: "https://www.graphcanon.com/compare/agent-sh-agentsys-vs-frankbria-ralph-claude-code"
tools: ["agent-sh-agentsys", "frankbria-ralph-claude-code"]
---

# agentsys vs ralph-claude-code

*GraphCanon updated Aug 20, 2026*

## Verdict

Pick agentsys if agentsys supports automation through AI agents that handle various coding environments with plugins and skills; pick ralph-claude-code if ralph provides an autonomous AI development workflow with intelligent exit detection specifically integrated to work with Claude Code.

[agentsys](https://agent-sh.github.io/agentsys/) reports 962 GitHub stars, 111 forks, and 0 open issues, last pushed Jul 26, 2026. [ralph-claude-code](https://github.com/frankbria/ralph-claude-code) has 9.6k stars, 723 forks, and 33 open issues, last pushed Jul 18, 2026. Figures are from public GitHub metadata via [agentsys's repository](https://github.com/agent-sh/agentsys) and [ralph-claude-code's repository](https://github.com/frankbria/ralph-claude-code).

| | [agentsys](/tools/agent-sh-agentsys.md) | [ralph-claude-code](/tools/frankbria-ralph-claude-code.md) |
| --- | --- | --- |
| Tagline | AI writes code to automate workflows and tasks | Autonomous AI development loop for Claude Code with intelligent exit detection |
| Stars | 962 | 9,604 |
| Forks | 111 | 723 |
| Open issues | 0 | 33 |
| Language | JavaScript | Shell |
| Adopt for | agentsys supports automation through AI agents that handle various coding environments with plugins and skills. | Ralph provides an autonomous AI development workflow with intelligent exit detection specifically integrated to work with Claude Code. |
| Persona | - | - |
| Runtime | - | - |
| License | MIT | MIT |
| Categories | AI Agents, Developer Tools | AI Agents, Developer Tools |

## Trust and health

_Sourced signals - not a safety guarantee. No winner column._

| | [agentsys](/tools/agent-sh-agentsys.md) | [ralph-claude-code](/tools/frankbria-ralph-claude-code.md) |
| --- | --- | --- |
| Maintenance | Active (82%) | Steady (60%) |
| Days since push | 16d | 33d |
| Open issues (now) | 0 | 33 |
| Stars delta | Unknown | +49 (30d) |
| Open issues delta | Unknown | +5 (30d) |
| Owner type | Organization | User |
| Full report | [trust report](/tools/agent-sh-agentsys/trust.md) | [trust report](/tools/frankbria-ralph-claude-code/trust.md) |

## Shared compatibility

- **Node.js**: [agentsys](/tools/agent-sh-agentsys.md) - Node.js runtime; [ralph-claude-code](/tools/frankbria-ralph-claude-code.md) - Node.js runtime

## Decision facts: agentsys

- **Pricing:** freemium - MIT licensed tool offers open access for free but may include premium plugins or skills.
- **Requirements:** Min 2 GB RAM; Requires modern JavaScript environment to run effectively.; Ensure internet connectivity due to reliance on plugins and skills that may require update downloads or external API access for certain functionalities.
- **Adopt for:** agentsys supports automation through AI agents that handle various coding environments with plugins and skills.

## Decision facts: ralph-claude-code

- **Requirements:** Requires Docker; - Requires Bash 4.0+ for script execution.; - Claude Code CLI must be installed (`npm install -g @anthropic-ai/claude-code`).; - tmux, jq, Git, and GNU coreutils are required system utilities.
- **Adopt for:** Ralph provides an autonomous AI development workflow with intelligent exit detection specifically integrated to work with Claude Code.

## Choose when

### Choose agentsys if…

- agentsys is primarily JavaScript; ralph-claude-code is Shell.
- Pricing: MIT licensed tool offers open access for free but may include premium plugins or skills..
- Requirements: Min 2 GB RAM; Requires modern JavaScript environment to run effectively.; Ensure internet connectivity due to reliance on plugins and skills that may require update downloads or external API access for certain functionalities..
- Tags unique to agentsys: agent, ai, automation, autonomous-agents.
- Use when you need to automate complex workflows in JavaScript-heavy projects, as it integrates well with JavaScript environments like Claude Code.

### Choose ralph-claude-code if…

- ralph-claude-code is primarily Shell; agentsys is JavaScript.
- Requirements: Requires Docker; - Requires Bash 4.0+ for script execution.; - Claude Code CLI must be installed (`npm install -g @anthropic-ai/claude-code`).; - tmux, jq, Git, and GNU coreutils are required system utilities..
- Tags unique to ralph-claude-code: ai-agents, ai-development-tools, development-workflow.
- ralph-claude-code ships Docker support for self-hosted deployment.
- - When you already have existing PRDs, specifications, or requirement documents that need conversion into the Ralph format and completeness assessment using Claude Code.

## When NOT to use agentsys

- Avoid for teams not proficient in JavaScript or those preferring languages where agentsys does not provide comparable support.
- Do not use if your project scope is better served by competitors with more specialized skill sets that align closely with niche requirements, as opposed to the general utility approach of agentsys.

## When NOT to use ralph-claude-code

- - If your development process does not rely heavily on PRDs or structured documents for specifications, as Ralph's primary strength lies in managing these.
- - If you don't want to integrate via an autonomous loop with intelligent exit detection, which is a key feature of Ralph compared to other workflow automation tools.

## Common questions

### What is the difference between agentsys and ralph-claude-code?

agentsys: AI writes code to automate workflows and tasks. ralph-claude-code: Autonomous AI development loop for Claude Code with intelligent exit detection. See the comparison table for live GitHub stats and shared categories.

### When should I choose agentsys over ralph-claude-code?

Choose agentsys over ralph-claude-code when agentsys is primarily JavaScript; ralph-claude-code is Shell; Pricing: MIT licensed tool offers open access for free but may include premium plugins or skills.; Requirements: Min 2 GB RAM; Requires modern JavaScript environment to run effectively.; Ensure internet connectivity due to reliance on plugins and skills that may require update downloads or external API access for certain functionalities.; Tags unique to agentsys: agent, ai, automation, autonomous-agents; Use when you need to automate complex workflows in JavaScript-heavy projects, as it integrates well with JavaScript environments like Claude Code.

### When should I choose ralph-claude-code over agentsys?

Choose ralph-claude-code over agentsys when ralph-claude-code is primarily Shell; agentsys is JavaScript; Requirements: Requires Docker; - Requires Bash 4.0+ for script execution.; - Claude Code CLI must be installed (`npm install -g @anthropic-ai/claude-code`).; - tmux, jq, Git, and GNU coreutils are required system utilities.; Tags unique to ralph-claude-code: ai-agents, ai-development-tools, development-workflow; ralph-claude-code ships Docker support for self-hosted deployment; - When you already have existing PRDs, specifications, or requirement documents that need conversion into the Ralph format and completeness assessment using Claude Code.

### When should I avoid agentsys?

Avoid for teams not proficient in JavaScript or those preferring languages where agentsys does not provide comparable support. Do not use if your project scope is better served by competitors with more specialized skill sets that align closely with niche requirements, as opposed to the general utility approach of agentsys.

### When should I avoid ralph-claude-code?

- If your development process does not rely heavily on PRDs or structured documents for specifications, as Ralph's primary strength lies in managing these. - If you don't want to integrate via an autonomous loop with intelligent exit detection, which is a key feature of Ralph compared to other workflow automation tools.

### Is agentsys or ralph-claude-code more popular on GitHub?

ralph-claude-code has more GitHub stars (9,604 vs 962). Stars measure visibility, not whether either tool fits your constraints.

### Are agentsys and ralph-claude-code open source?

Yes - both are open-source projects on GitHub (agentsys: MIT, ralph-claude-code: MIT).

### Where can I find alternatives to agentsys or ralph-claude-code?

GraphCanon lists graph-backed alternatives at [agentsys alternatives](/tools/agent-sh-agentsys/alternatives) and [ralph-claude-code alternatives](/tools/frankbria-ralph-claude-code/alternatives) ([agentsys markdown twin](/tools/agent-sh-agentsys/alternatives.md), [ralph-claude-code markdown twin](/tools/frankbria-ralph-claude-code/alternatives.md)), ranked by typed relationship edges rather than popularity votes.

### Is there a machine-readable version of this comparison?

Yes. The markdown twin at [this comparison](/compare/agent-sh-agentsys-vs-frankbria-ralph-claude-code.md) mirrors this page for agents and LLM crawlers, with the same stats table and FAQ answers.

### Which is better maintained, agentsys or ralph-claude-code?

agentsys: Active. ralph-claude-code: Steady. Compare maintenance labels, days since push, and release cadence in the trust section below - stars alone do not measure maintenance.

### Where are the full trust reports for agentsys and ralph-claude-code?

GraphCanon publishes per-repo trust reports with dated maintenance, provenance, and scan summaries: [agentsys trust report](/tools/agent-sh-agentsys/trust); [ralph-claude-code trust report](/tools/frankbria-ralph-claude-code/trust).

---

**Machine-readable endpoints**

- JSON: [`/api/graphcanon/graph?tool=agent-sh-agentsys`](/api/graphcanon/graph?tool=agent-sh-agentsys)
- LLM index: [/llms.txt](/llms.txt)
- Full corpus: [/llms-full.txt](/llms-full.txt)

_GraphCanon - The knowledge graph for AI development. https://www.graphcanon.com/_
