@rcrsr/claude-code-runner 0.7.0 → 0.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +24 -4
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -1,13 +1,14 @@
1
1
  # Claude Code Runner
2
2
 
3
- Deterministic, scripted, unattended Claude Code execution.
3
+ Deterministic, scripted, unattended Claude Code execution with [Rill](https://github.com/rcrsr/rill) scripting.
4
4
 
5
5
  ## Why Use This?
6
6
 
7
+ - **Rich scripting** — Fully scriptable with variables, conditionals, loops, and functions
7
8
  - **Walk away** — Workflows run unattended in CI/CD pipelines
8
9
  - **Chain results** — Capture output from one step, inject it into the next
9
- - **Claude decides** — Signals control when to retry, escalate, or finish
10
- - **No hitting context limits** — Fresh context per step keeps long workflows running
10
+ - **Claude decides** — Results protocol lets Claude control flow with `<ccr:result type="..."/>`
11
+ - **No context limits** — Fresh context per step keeps long workflows running
11
12
  - **Watch live** — See tool calls stream as they execute
12
13
  - **Replay later** — Full session logs for debugging
13
14
 
@@ -75,7 +76,14 @@ Review $1 with severity level $2...
75
76
 
76
77
  ### script — Run multi-phase workflows
77
78
 
78
- Scripts use [Rill](https://github.com/rcrsr/rill) to chain commands where each phase builds on the previous.
79
+ Scripts use [Rill](https://github.com/rcrsr/rill), a scripting language designed for AI workflows. Rill provides:
80
+
81
+ - **Variables & capture** — Store Claude's output with `:>` operator
82
+ - **Conditionals** — Branch logic with `(condition) ? action`
83
+ - **Loops** — Iterate with `for` and `while`
84
+ - **Functions** — Reusable logic blocks
85
+ - **String interpolation** — Embed variables with `{$var}` syntax
86
+ - **Heredocs** — Multi-line prompts with `<<EOF...EOF`
79
87
 
80
88
  ```bash
81
89
  claude-code-runner script workflow.rill src/api/
@@ -105,6 +113,18 @@ EOF
105
113
  ccr::prompt("Summarize: Issues: {$issues} Fixes: {$fixes}")
106
114
  ```
107
115
 
116
+ **Host functions:**
117
+
118
+ | Function | Description |
119
+ | ----------------------------- | ---------------------------------- |
120
+ | `ccr::prompt(text, model?)` | Execute a Claude prompt |
121
+ | `ccr::command(name, args?)` | Run a command template |
122
+ | `ccr::skill(name, args?)` | Run a slash command |
123
+ | `ccr::get_result(text)` | Extract `<ccr:result>` from output |
124
+ | `ccr::file_exists(path)` | Check if file exists |
125
+ | `ccr::read_frontmatter(path)` | Parse YAML frontmatter |
126
+ | `ccr::error(message?)` | Stop execution with error |
127
+
108
128
  See [docs/rill-scripting.md](docs/rill-scripting.md) for the full scripting reference.
109
129
 
110
130
  ### Options
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@rcrsr/claude-code-runner",
3
- "version": "0.7.0",
3
+ "version": "0.7.1",
4
4
  "description": "Execute Claude CLI with PTY handling, real-time tool visualization, and iterative execution support",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -46,7 +46,7 @@
46
46
  "author": "Andre Bremer",
47
47
  "license": "MIT",
48
48
  "dependencies": {
49
- "@rcrsr/rill": "file:../rill",
49
+ "@rcrsr/rill": "^0.1.0",
50
50
  "node-pty": "^1.0.0"
51
51
  },
52
52
  "devDependencies": {