Claude Code Runner

Claude Code Runner

[](https://github.com/rcrsr/claude-code-runner/actions/workflows/pr-check.yml) [](https://www.npmjs.com/package/@rcrsr/claude-code-runner) [](https://www.npmjs.com/package/@rcrsr/claude-code-runner) [](https://github.com/rcrsr/claude-code-runner/blob/main/LICENSE)

Deterministic, scripted, unattended Claude Code execution with [rill](https://rill.run) scripting.

Why Use This?

Like [Ralph Wiggum](https://awesomeclaude.ai/ralph-wiggum), but smarter.

• Rich scripting — Fully scriptable with variables, conditionals, loops, and functions
• Walk away — Workflows can run unattended for hours if needed
• Treat Claude Code Skills as Functions — Call with arguments and get back return values through
• Fresh context — Each invocation starts with a clean slate
• Watch live — See your calls log activity as they execute
• Inspect later — Full session logs for debugging

Prerequisites

• Node.js 22.16 or later
• Claude Code installed and authenticated

Installation

Install Claude Code Runner globally:

npm install -g @rcrsr/claude-code-runner

Usage

prompt — Run a single prompt

claude-code-runner prompt "Refactor the auth module to use async/await"

skill — Run a Claude Code Skill file

Run skills by name:

claude-code-runner skill review-code src/auth.ts

**Example skill** (`.claude/skills/review-code/SKILL.md`):

---
description: Review code for issues
argument-hint:  [severity]
model: sonnet
---

Review the code in $1 for:

- Security vulnerabilities
- Performance issues
- Code style violations

Outpu