openrune 2.0.0 → 2.0.1

package/README.ko.md

@@ -31,9 +31,29 @@ npm install -g @anthropic-ai/claude-code
 claude                                       # 로그인이 안 되어 있다면 실행
 ```
 
-> **Rune의 작동 방식:** Rune은 각 에이전트 호출 시 Claude Code를 서브프로세스로 실행합니다. Claude API에 직접 접근하거나 인증을 처리하지 않으며, 모든 실행은 공식 Claude Code CLI를 통해 이루어집니다.
+### Rune의 작동 방식
 
-> **사용량:** Rune은 사용자의 Claude Code CLI 세션을 통해 실행됩니다. 사용량은 일반 Claude Code 구독에서 차감됩니다.
+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 (이미 로그인된 세션)
+```
+
+핵심 요약:
+- **API 키 없음, OAuth 가로채기 없음.** Rune은 이미 인증된 `claude` CLI를 그대로 사용합니다.
+- **MCP 격리.** `--mcp-config '{"mcpServers":{}}' --strict-mcp-config` 를 넘겨서 프로젝트의 `.mcp.json`이 에이전트 실행 중 자동 로드되지 않도록 합니다. 작업 폴더의 파일은 건드리지 않습니다.
+- **상태는 `.rune` 파일에.** 역할, 메모리, 대화 히스토리는 디스크에 있는 평범한 JSON입니다. Rune은 매 실행마다 이를 시스템 프롬프트에 주입합니다 — 이것이 서버 없이 영구 저장이 가능한 이유입니다.
+- **사용량:** Claude Code CLI 세션을 통해 실행되므로 일반 Claude Code 구독에서 차감됩니다.
 
 ## 설치
 

package/README.md

@@ -31,9 +31,29 @@ npm install -g @anthropic-ai/claude-code
 claude                                       # login if you haven't
 ```
 
-> **How Rune works:** Rune spawns Claude Code as a subprocess for each agent invocation. It does not access the Claude API directly or handle any authentication — all execution goes through the official Claude Code CLI.
+### How Rune works
 
-> **Usage:** Rune runs through your Claude Code CLI session. Usage counts toward your normal Claude Code subscription.
+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)
+```
+
+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
 

package/bin/rune.js

@@ -3,7 +3,6 @@
 const { spawn } = require('child_process')
 const path = require('path')
 const fs = require('fs')
-const os = require('os')
 
 const [,, command, ...args] = process.argv
 
@@ -180,16 +179,9 @@ function runRune(file, restArgs) {
   if (autoMode) {
     console.log(`🔮 [auto] ${rune.name} is working on: ${prompt}\n`)
 
-    // Temporarily hide .mcp.json to prevent MCP interference
-    const mcpPath = path.join(folderPath, '.mcp.json')
-    const mcpBackup = path.join(folderPath, '.mcp.json.bak')
-    let mcpHidden = false
-    if (fs.existsSync(mcpPath)) {
-      fs.renameSync(mcpPath, mcpBackup)
-      mcpHidden = true
-    }
-
     const claudeArgs = ['-p', '--print',
+      '--mcp-config', '{"mcpServers":{}}',
+      '--strict-mcp-config',
       '--dangerously-skip-permissions',
       '--verbose',
       '--output-format', 'stream-json',
@@ -203,12 +195,6 @@ function runRune(file, restArgs) {
     }
     claudeArgs.push(prompt)
 
-    const restoreMcp = () => {
-      if (mcpHidden && fs.existsSync(mcpBackup)) {
-        fs.renameSync(mcpBackup, mcpPath)
-      }
-    }
-
     const child = spawn('claude', claudeArgs, {
       cwd: folderPath,
       stdio: ['ignore', 'pipe', 'pipe'],
@@ -273,7 +259,6 @@ function runRune(file, restArgs) {
     child.stderr.on('data', (d) => { process.stderr.write(d) })
 
     child.on('close', (code) => {
-      restoreMcp()
       // Save to history
       rune.history = rune.history || []
       rune.history.push({ role: 'user', text: prompt, ts: Date.now() })
@@ -306,16 +291,15 @@ function runRune(file, restArgs) {
       process.exit(code || 0)
     })
 
-    // Restore .mcp.json if process is killed
-    process.on('SIGINT', restoreMcp)
-    process.on('SIGTERM', restoreMcp)
-
     return
   }
 
   // Normal mode: print-only, no tool execution
-  // Run from tmpdir to avoid .mcp.json interference, add project folder via --add-dir
-  const claudeArgs = ['-p', '--print', '--add-dir', folderPath]
+  const claudeArgs = [
+    '-p', '--print',
+    '--mcp-config', '{"mcpServers":{}}',
+    '--strict-mcp-config',
+  ]
   if (systemPrompt) {
     claudeArgs.push('--system-prompt', systemPrompt + `\nWorking folder: ${folderPath}`)
   }
@@ -325,7 +309,7 @@ function runRune(file, restArgs) {
   claudeArgs.push('--', prompt)
 
   const child = spawn('claude', claudeArgs, {
-    cwd: os.tmpdir(),
+    cwd: folderPath,
     stdio: ['ignore', 'pipe', 'pipe'],
     env: { ...process.env },
   })
@@ -434,16 +418,9 @@ async function pipeRunes(args) {
     const useAuto = autoMode && isLast
 
     if (useAuto) {
-      // Temporarily hide .mcp.json
-      const mcpPath = path.join(folderPath, '.mcp.json')
-      const mcpBackup = path.join(folderPath, '.mcp.json.pipe.bak')
-      let mcpHidden = false
-      if (fs.existsSync(mcpPath)) {
-        fs.renameSync(mcpPath, mcpBackup)
-        mcpHidden = true
-      }
-
       const claudeArgs = ['-p', '--print',
+        '--mcp-config', '{"mcpServers":{}}',
+        '--strict-mcp-config',
         '--dangerously-skip-permissions',
         '--verbose',
         '--output-format', 'stream-json',
@@ -494,7 +471,6 @@ async function pipeRunes(args) {
         })
         child.stderr.on('data', (d) => { process.stderr.write(d) })
         child.on('close', (code) => {
-          if (mcpHidden && fs.existsSync(mcpBackup)) fs.renameSync(mcpBackup, mcpPath)
           if (code !== 0) reject(new Error(`Agent ${rune.name} exited with code ${code}`))
           else resolve(fullOutput.trim())
         })
@@ -508,8 +484,12 @@ async function pipeRunes(args) {
       currentInput = output
 
     } else {
-      // Normal pipe step: text output only, run from tmpdir to avoid .mcp.json
-      const claudeArgs = ['-p', '--print', '--add-dir', folderPath]
+      // Normal pipe step: text output only
+      const claudeArgs = [
+        '-p', '--print',
+        '--mcp-config', '{"mcpServers":{}}',
+        '--strict-mcp-config',
+      ]
       if (systemParts.length > 0) {
         claudeArgs.push('--system-prompt', systemParts.join('\n') + `\nWorking folder: ${folderPath}`)
       }
@@ -517,7 +497,7 @@ async function pipeRunes(args) {
 
       const output = await new Promise((resolve, reject) => {
         const child = spawn('claude', claudeArgs, {
-          cwd: os.tmpdir(),
+          cwd: folderPath,
           stdio: ['ignore', 'pipe', 'pipe'],
           env: { ...process.env },
         })
@@ -690,15 +670,9 @@ async function loopRunes(args) {
 
 async function runAgent(name, folderPath, systemParts, prompt, autoMode) {
   if (autoMode) {
-    const mcpPath = path.join(folderPath, '.mcp.json')
-    const mcpBackup = path.join(folderPath, '.mcp.json.loop.bak')
-    let mcpHidden = false
-    if (fs.existsSync(mcpPath)) {
-      fs.renameSync(mcpPath, mcpBackup)
-      mcpHidden = true
-    }
-
     const claudeArgs = ['-p', '--print',
+      '--mcp-config', '{"mcpServers":{}}',
+      '--strict-mcp-config',
       '--dangerously-skip-permissions',
       '--verbose',
       '--output-format', 'stream-json',
@@ -748,7 +722,6 @@ async function runAgent(name, folderPath, systemParts, prompt, autoMode) {
       })
       child.stderr.on('data', (d) => { process.stderr.write(d) })
       child.on('close', (code) => {
-        if (mcpHidden && fs.existsSync(mcpBackup)) fs.renameSync(mcpBackup, mcpPath)
         if (code !== 0) reject(new Error(`Agent ${name} exited with code ${code}`))
         else resolve(fullOutput.trim())
       })
@@ -756,8 +729,11 @@ async function runAgent(name, folderPath, systemParts, prompt, autoMode) {
 
     return output
   } else {
-    const tmpdir = require('os').tmpdir()
-    const claudeArgs = ['-p', '--print', '--add-dir', folderPath]
+    const claudeArgs = [
+      '-p', '--print',
+      '--mcp-config', '{"mcpServers":{}}',
+      '--strict-mcp-config',
+    ]
     if (systemParts.length > 0) {
       claudeArgs.push('--system-prompt', systemParts.join('\n') + `\nWorking folder: ${folderPath}`)
     }
@@ -765,7 +741,7 @@ async function runAgent(name, folderPath, systemParts, prompt, autoMode) {
 
     const output = await new Promise((resolve, reject) => {
       const child = spawn('claude', claudeArgs, {
-        cwd: tmpdir,
+        cwd: folderPath,
         stdio: ['ignore', 'pipe', 'pipe'],
         env: { ...process.env },
       })

package/package.json

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