openrune 2.0.2 → 2.0.4

package/README.ko.md

@@ -21,17 +21,20 @@
 
 ---
 
-## 사전 준비
+## Rune을 왜 쓰나요?
 
-- **Node.js** 18+
-- **Claude Code CLI** 설치 및 로그인 — Rune은 모든 에이전트 실행에 Claude Code를 사용합니다
+Claude Code는 이미 서브에이전트, 훅, 스킬, 헤드리스 모드를 기본 제공합니다. Rune은 **거기에 없는 것**을 채웁니다:
 
-```bash
-npm install -g @anthropic-ai/claude-code
-claude                                       # 로그인이 안 되어 있다면 실행
-```
+- **파일 하나 = 에이전트 하나.** Claude Code에 `--resume` 이 있긴 하지만, 세션 스레드는 디렉토리별로 이름도 역할도 없이 계속 쌓여서 "지난주에 쓰던 그 리뷰어 대화"를 다시 찾아 들어가기가 쉽지 않아요. Rune은 **에이전트에 관한 모든 것을 `.rune` 파일 하나에** 담습니다 — 역할, 권한, 메모리, 전체 기록까지. 이름을 붙이고, git에 커밋하고, 공유하고, 다른 프로젝트로 옮기세요. 에이전트 10개 관리 = 파일 10개 관리.
+- **자가 수정 루프.** `rune loop coder.rune reviewer.rune "..." --until "no critical issues"` — 중단 조건을 만족하거나 최대 반복 횟수에 도달할 때까지 실행자/리뷰어 사이클을 돌립니다. 스크립트 작성 불필요.
+- **에이전트별 권한.** 리뷰어는 `fileWrite: false` + `allowPaths: ["src/**"]` 로 잠그고, 같은 프로젝트의 코더는 어디든 쓸 수 있게. 가드레일이 세션이 아니라 파일을 따라다닙니다.
+- **한 줄 트리거.** `rune watch agent.rune --on cron --interval 5m` — 훅 설정 없이 스케줄, 파일 변경, 깃 커밋 트리거를 바로 걸 수 있어요.
+
+한 세션 안에서 일회성으로 쓸 전문화된 에이전트가 필요한 거라면 Claude Code의 기본 서브에이전트로 충분합니다. 같은 에이전트가 **내일도 돌아와야 하거나, 스케줄로 돌거나, 팀원에게 넘겨줘야 할 때** Rune을 꺼내 쓰세요.
 
-### Rune의 작동 방식
+---
+
+## Rune의 작동 방식
 
 Rune은 Claude API를 호출하거나, 인증 정보를 다루거나, Claude Code 내부를 래핑하지 않습니다. 모든 에이전트 호출은 공식 `claude` CLI에 대한 단순한 서브프로세스 호출입니다:
 
@@ -55,6 +58,18 @@ Claude Code CLI (이미 로그인된 세션)
 - **상태는 `.rune` 파일에.** 역할, 메모리, 대화 히스토리는 디스크에 있는 평범한 JSON입니다. Rune은 매 실행마다 이를 시스템 프롬프트에 주입합니다 — 이것이 서버 없이 영구 저장이 가능한 이유입니다.
 - **사용량:** Claude Code CLI 세션을 통해 실행되므로 일반 Claude Code 구독에서 차감됩니다.
 
+---
+
+## 사전 준비
+
+- **Node.js** 18+
+- **Claude Code CLI** 설치 및 로그인 — Rune은 모든 에이전트 실행에 Claude Code를 사용합니다
+
+```bash
+npm install -g @anthropic-ai/claude-code
+claude                                       # 로그인이 안 되어 있다면 실행
+```
+
 ## 설치
 
 ```bash

package/README.md

@@ -21,17 +21,20 @@
 
 ---
 
-## Prerequisites
+## Why Rune?
 
-- **Node.js** 18+
-- **Claude Code CLI** installed and logged in — Rune uses Claude Code under the hood for all agent execution
+Claude Code already ships with subagents, hooks, skills, and headless mode. Rune is for the things that aren't built in:
 
-```bash
-npm install -g @anthropic-ai/claude-code
-claude                                       # login if you haven't
-```
+- **One file = one agent.** Claude Code has `--resume`, but session threads pile up per directory with no names, no roles, and no way to tell which is which — good luck finding "that reviewer conversation from last week." Rune puts **everything about an agent into a single `.rune` file**: role, permissions, memory, full history. Name it, commit it, share it, drop it into another project. Managing 10 agents is managing 10 files.
+- **Self-correction loops.** `rune loop coder.rune reviewer.rune "..." --until "no critical issues"` runs a doer/reviewer cycle until the stop condition is met or max iterations are reached. No scripting.
+- **Per-agent permissions.** Lock a reviewer to `fileWrite: false` with `allowPaths: ["src/**"]`. A coder on the same project can still write anywhere. The guardrails travel with the file, not the session.
+- **One-line triggers.** `rune watch agent.rune --on cron --interval 5m` — scheduled, file-change, and git-commit triggers without writing hook configs.
+
+If you just want a one-off specialized agent inside a single session, Claude Code's built-in subagents are perfect. Reach for Rune when the same agent needs to come back tomorrow, run on a schedule, or be handed off to a teammate.
 
-### How Rune works
+---
+
+## How Rune works
 
 Rune does not call the Claude API, handle any credentials, or wrap Claude Code's internals. Every agent invocation is a plain subprocess call to the official `claude` CLI:
 
@@ -55,6 +58,18 @@ Key points:
 - **State lives in the `.rune` file.** Role, memory, and conversation history are plain JSON on your disk. Rune injects them into the system prompt each run — that's how persistence works without any server.
 - **Usage:** runs through your Claude Code CLI session, so usage counts toward your normal Claude Code subscription.
 
+---
+
+## Prerequisites
+
+- **Node.js** 18+
+- **Claude Code CLI** installed and logged in — Rune uses Claude Code under the hood for all agent execution
+
+```bash
+npm install -g @anthropic-ai/claude-code
+claude                                       # login if you haven't
+```
+
 ## Install
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openrune",
-  "version": "2.0.2",
+  "version": "2.0.4",
   "description": "Persistent AI agents for Claude Code — build once, run forever.",
   "keywords": ["ai", "agent", "claude", "claude-code", "cli", "toolkit", "automation"],
   "repository": {