openrune 1.1.2 → 2.0.1

package/README.ko.md

@@ -19,10 +19,6 @@
   <img src="https://img.shields.io/badge/license-MIT-green" alt="license" />
 </p>
 
-<p align="center">
-  <img src="screenshot-chatting-ui.png" width="800" alt="Rune 데스크톱 UI — 4개 에이전트 협업" />
-</p>
-
 ---
 
 ## 사전 준비
@@ -35,9 +31,29 @@ npm install -g @anthropic-ai/claude-code
 claude                                       # 로그인이 안 되어 있다면 실행
 ```
 
-> **Rune의 작동 방식:** Rune은 Claude Code의 커스텀 채널(현재 베타)을 사용하여 에이전트 기능을 확장합니다. Claude API에 직접 접근하거나 인증을 처리하지 않으며, 모든 실행은 공식 Claude Code CLI를 통해 이루어집니다.
+### Rune의 작동 방식
+
+Rune은 Claude API를 호출하거나, 인증 정보를 다루거나, Claude Code 내부를 래핑하지 않습니다. 모든 에이전트 호출은 공식 `claude` CLI에 대한 단순한 서브프로세스 호출입니다:
+
+```
+rune run reviewer.rune "..."
+      │
+      ▼
+spawn('claude', ['-p', '--print',
+                 '--mcp-config', '{"mcpServers":{}}',
+                 '--strict-mcp-config',
+                 '--system-prompt', <역할 + 메모리 + 최근 대화>,
+                 '--', <사용자 프롬프트>])
+      │
+      ▼
+Claude Code CLI (이미 로그인된 세션)
+```
 
-> **사용량:** Rune은 사용자의 Claude Code CLI 세션을 통해 실행됩니다. 사용량은 일반 Claude Code 구독에서 차감됩니다.
+핵심 요약:
+- **API 키 없음, OAuth 가로채기 없음.** Rune은 이미 인증된 `claude` CLI를 그대로 사용합니다.
+- **MCP 격리.** `--mcp-config '{"mcpServers":{}}' --strict-mcp-config` 를 넘겨서 프로젝트의 `.mcp.json`이 에이전트 실행 중 자동 로드되지 않도록 합니다. 작업 폴더의 파일은 건드리지 않습니다.
+- **상태는 `.rune` 파일에.** 역할, 메모리, 대화 히스토리는 디스크에 있는 평범한 JSON입니다. Rune은 매 실행마다 이를 시스템 프롬프트에 주입합니다 — 이것이 서버 없이 영구 저장이 가능한 이유입니다.
+- **사용량:** Claude Code CLI 세션을 통해 실행되므로 일반 Claude Code 구독에서 차감됩니다.
 
 ## 설치
 
@@ -45,6 +61,10 @@ claude                                       # 로그인이 안 되어 있다면
 npm install -g openrune
 ```
 
+순수 Node.js CLI — Electron, GUI, postinstall 스크립트 없음.
+
+> 채팅 GUI를 찾으신다면 **[RuneChat](https://github.com/gilhyun/runechat)** 을 확인하세요 — `.rune` 에이전트를 위한 데스크톱 메신저 앱입니다.
+
 ---
 
 ## 30초 빠른 시작
@@ -282,75 +302,6 @@ const { finalOutput } = await rune.pipe(
 
 ---
 
-## 예제: 에이전트 기반 API 서버
-
-처음부터 에이전트가 구축한 서버까지의 전체 과정.
-
-### 1. 설치 및 에이전트 생성
-
-```bash
-npm install -g openrune
-mkdir my-project && cd my-project
-
-rune new architect --role "Software architect. Design system architecture concisely."
-rune new coder --role "Backend developer. Implement code based on the given plan."
-rune new reviewer --role "Code reviewer. Review for bugs and security issues."
-```
-
-### 2. 에이전트가 협업하여 서버 구축
-
-```bash
-rune pipe architect.rune coder.rune "Design and build an Express server with POST /review endpoint that uses require('openrune') to load reviewer.rune and send the prompt. Run npm init -y and npm install express openrune." --auto
-```
-
-architect가 아키텍처 설계 → coder가 `server.js` 작성, `npm init` 실행, 의존성 설치.
-
-### 3. 서버 시작
-
-```bash
-node server.js
-```
-
-### 4. API로 에이전트 호출
-
-```bash
-curl -X POST http://localhost:3000/review \
-  -H "Content-Type: application/json" \
-  -d '{"prompt": "Review this project"}'
-```
-
-reviewer 에이전트가 프로젝트를 분석하고 전체 코드 리뷰를 반환합니다.
-
-### 5. 데스크톱 UI 열기
-
-```bash
-rune open reviewer.rune
-```
-
-API 호출의 대화 히스토리가 이미 있습니다 — CLI, API, GUI 간에 컨텍스트가 유지됩니다.
-
----
-
-## 데스크톱 UI
-
-Rune은 대화형 채팅을 위한 선택적 데스크톱 앱을 포함합니다.
-
-```bash
-rune open reviewer.rune
-```
-
-또는 Finder에서 `.rune` 파일을 더블 클릭하세요.
-
-<p align="center">
-  <img src="screenshot-chatting-ui.png" width="800" alt="Rune 데스크톱 UI" />
-</p>
-
-- **실시간 활동** — 도구 호출, 결과, 권한 요청을 실시간으로 확인.
-- **내장 터미널** — Claude Code 출력과 사용자 명령어를 나란히.
-- **우클릭으로 생성** — macOS Quick Action으로 Finder에서 에이전트 생성.
-
-> 더블 클릭이 작동하지 않으면 `rune install`을 한 번 실행하여 파일 연결을 등록하세요.
-
 ---
 
 ## CLI 레퍼런스
@@ -362,9 +313,7 @@ rune open reviewer.rune
 | `rune pipe <a> <b> [...] "prompt" [--auto]` | 에이전트 체이닝 |
 | `rune loop <doer> <reviewer> "prompt" [--until "..."] [--max-iterations N] [--auto]` | 자기 수정 루프 |
 | `rune watch <file> --on <event> --prompt "..."` | 자동화 트리거 |
-| `rune open <file>` | 데스크톱 UI |
 | `rune list` | 현재 디렉토리의 에이전트 목록 |
-| `rune install` | 파일 연결 및 Quick Action 설정 |
 
 **Watch 이벤트:** `git-commit`, `git-push`, `file-change` (`--glob` 사용), `cron` (`--interval` 사용)
 

package/README.md

@@ -19,10 +19,6 @@
   <img src="https://img.shields.io/badge/license-MIT-green" alt="license" />
 </p>
 
-<p align="center">
-  <img src="screenshot-chatting-ui.png" width="800" alt="Rune Desktop UI — 4 agents collaborating" />
-</p>
-
 ---
 
 ## Prerequisites
@@ -35,9 +31,29 @@ npm install -g @anthropic-ai/claude-code
 claude                                       # login if you haven't
 ```
 
-> **How Rune works:** Rune uses Claude Code's custom channels (currently in beta) to extend agent capabilities. It does not access the Claude API directly or handle any authentication — all execution goes through the official Claude Code CLI.
+### 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:
+
+```
+rune run reviewer.rune "..."
+      │
+      ▼
+spawn('claude', ['-p', '--print',
+                 '--mcp-config', '{"mcpServers":{}}',
+                 '--strict-mcp-config',
+                 '--system-prompt', <role + memory + recent history>,
+                 '--', <your prompt>])
+      │
+      ▼
+Claude Code CLI (your logged-in session)
+```
 
-> **Usage:** Rune runs through your Claude Code CLI session. Usage counts toward your normal Claude Code subscription.
+Key points:
+- **No API key, no OAuth shim.** Rune uses your already-authenticated `claude` CLI as-is.
+- **MCP isolation.** Rune passes `--mcp-config '{"mcpServers":{}}' --strict-mcp-config` so your project's `.mcp.json` never gets auto-loaded during an agent run. Nothing in your working folder is touched.
+- **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.
 
 ## Install
 
@@ -45,6 +61,10 @@ claude                                       # login if you haven't
 npm install -g openrune
 ```
 
+Pure Node.js CLI — no Electron, no GUI, no postinstall scripts.
+
+> Looking for a chat GUI? See **[RuneChat](https://github.com/gilhyun/runechat)** — a desktop messenger for your `.rune` agents.
+
 ---
 
 ## 30-Second Quick Start
@@ -159,7 +179,7 @@ rune run manager.rune "Create a summarizer and a translator agent, then pipe the
 ```
 
 The manager will:
-1. Run `rune new summarizer --role "..."` 
+1. Run `rune new summarizer --role "..."`
 2. Run `rune new translator --role "..."`
 3. Run `rune pipe summarizer.rune translator.rune "..."`
 4. If something fails, debug and fix it autonomously
@@ -168,7 +188,7 @@ Agents creating agents. No human intervention.
 
 ### Headless execution
 
-Run agents from the terminal. No GUI needed:
+Run agents from the terminal:
 
 ```bash
 rune run reviewer.rune "Review the latest commit"
@@ -282,77 +302,6 @@ const { finalOutput } = await rune.pipe(
 
 ---
 
-## Example: Agent-Powered API Server
-
-A full walkthrough — from zero to a running server built by agents.
-
-### 1. Install and create agents
-
-```bash
-npm install -g openrune
-mkdir my-project && cd my-project
-
-rune new architect --role "Software architect. Design system architecture concisely."
-rune new coder --role "Backend developer. Implement code based on the given plan."
-rune new reviewer --role "Code reviewer. Review for bugs and security issues."
-```
-
-### 2. Agents collaborate to build a server
-
-```bash
-rune pipe architect.rune coder.rune "Design and build an Express server with POST /review endpoint that uses require('openrune') to load reviewer.rune and send the prompt. Run npm init -y and npm install express openrune." --auto
-```
-
-architect designs the architecture → coder writes `server.js`, runs `npm init`, installs dependencies.
-
-### 3. Start the server
-
-```bash
-node server.js
-```
-
-### 4. Call the agent via API
-
-```bash
-curl -X POST http://localhost:3000/review \
-  -H "Content-Type: application/json" \
-  -d '{"prompt": "Review this project"}'
-```
-
-The reviewer agent analyzes your project and returns a full code review.
-
-### 5. Open the desktop UI
-
-```bash
-rune open reviewer.rune
-```
-
-The conversation history from the API call is already there — context persists across CLI, API, and GUI.
-
----
-
-## Desktop UI
-
-Rune includes an optional desktop app for interactive chat.
-
-```bash
-rune open reviewer.rune
-```
-
-Or double-click any `.rune` file in Finder.
-
-<p align="center">
-  <img src="screenshot-chatting-ui.png" width="800" alt="Rune Desktop UI" />
-</p>
-
-- **Real-time activity** — See tool calls, results, and permission requests as they happen.
-- **Built-in terminal** — Claude Code output and your own commands, side by side.
-- **Right-click to create** — macOS Quick Action for creating agents from Finder.
-
-> If double-click doesn't work, run `rune install` once to register the file association.
-
----
-
 ## CLI Reference
 
 | Command | Description |
@@ -362,9 +311,7 @@ Or double-click any `.rune` file in Finder.
 | `rune pipe <a> <b> [...] "prompt" [--auto]` | Chain agents |
 | `rune loop <doer> <reviewer> "prompt" [--until "..."] [--max-iterations N] [--auto]` | Self-correction loop |
 | `rune watch <file> --on <event> --prompt "..."` | Automated triggers |
-| `rune open <file>` | Desktop UI |
 | `rune list` | List agents in current directory |
-| `rune install` | Set up file associations & Quick Action |
 
 **Watch events:** `git-commit`, `git-push`, `file-change` (with `--glob`), `cron` (with `--interval`)