RuneOrchestrator - Universal Harvester+Launcher CLI

English | 日本語

English

A cross-platform npm CLI that harvests context from your repository and launches AI runners with enriched prompts.

What it does

rune always runs a built-in harvester first to collect context files (AGENTS.md, SECURITY.md, CI-Error-Prevention.md, SPEC.md), then launches your chosen AI runner (codex, claude, openai) with this context prepended to your prompt.

Why

• Consistent context: Every AI interaction starts with your project's rules and specifications
• Spec immutability: Enforces SPEC.md lock with SHA256 verification
• Runner agnostic: Works with any AI CLI tool
• Zero configuration: Auto-detects installed runners
• Secure: No telemetry, no network calls, no secret collection

Installation

npm install -g @rune/orchestrator
# or for development
npm link

Setup (One-time)

1. Create your configuration directory:

mkdir -p ~/.config/rune-orchestrator

2. Place your personal rule files there:

# Create these files with your own content:
~/.config/rune-orchestrator/AGENTS.md
~/.config/rune-orchestrator/SECURITY.md
~/.config/rune-orchestrator/CI-Error-Prevention.md

3. Optionally create custom prompts:

mkdir -p ~/.config/rune-orchestrator/prompts
# Add your custom prompt files here

Usage

Navigate to a Git repository that contains a SPEC.md file (or docs/SPEC.md):

cd /your/project  # Must have SPEC.md
# Create spec lock file
shasum -a 256 SPEC.md | awk '{print $1}' > .spec.lock

# Run commands
rune mop          # Run Master Orchestrator
rune dev          # Run Dev Start
rune cd-setup     # Run CD Setup
rune release      # Run Release Publish
rune custom ./my-prompt.txt  # Run custom prompt

Pass additional arguments to the runner:

rune mop -- --verbose
rune custom prompt.txt -- --model gpt-4-turbo

File Search Order

SPEC.md (required in repo):

1. <repo-root>/SPEC.md
2. <repo-root>/docs/SPEC.md

AGENTS.md, SECURITY.md, CI-Error-Prevention.md:

1. <repo-root>/<file> (repo-specific overrides)
2. $HARVESTER_PATH/<file> (if env var set)
3. ~/.config/rune-orchestrator/<file> (user defaults)

Prompt files:

1. ~/.config/rune-orchestrator/prompts/<file>
2. ./.prompts/<file> (repo-local)
3. Package built-in prompts

Environment Variables

• RUNE_RUNNER: Override runner detection (codex, claude, openai, auto)
• RUNE_RUNNER_CMD: Path to custom runner executable
• RUNE_RUNNER_ARGS: Default arguments for custom runner
• HARVESTER_PATH: Additional directory to search for context files
• XDG_CONFIG_HOME: Override config directory base (default: ~/.config)

Exit Codes

• 0: Success
• 1: General error
• 10: Not in a Git repository
• 12: SPEC.md hash mismatch with .spec.lock
• 13: No AI runner found
• 14: Missing required context files

Security

• No secrets are read or transmitted
• No network connections made
• No telemetry collected
• Only spawns the runner you specify
• SPEC.md is locked with SHA256 verification

License

MIT

日本語

リポジトリからコンテキストを収集し、AIランナーに豊富なプロンプトを提供するクロスプラットフォームnpm CLIツールです。

機能

runeは最初に組み込みのハーベスター（収集機）を実行してコンテキストファイル（AGENTS.md、SECURITY.md、CI-Error-Prevention.md、SPEC.md）を収集し、選択したAIランナー（codex、claude、openai）を起動する際に、このコンテキストをプロンプトの前に追加します。

なぜ必要か

• 一貫したコンテキスト: すべてのAIインタラクションがプロジェクトのルールと仕様から開始
• 仕様の不変性: SHA256検証によるSPEC.mdロックの強制
• ランナー非依存: あらゆるAI CLIツールで動作
• ゼロ設定: インストール済みランナーを自動検出
• セキュア: テレメトリなし、ネットワーク接続なし、シークレット収集なし

インストール

npm install -g @rune/orchestrator
# または開発用
npm link

セットアップ（初回のみ）

1. 設定ディレクトリを作成:

mkdir -p ~/.config/rune-orchestrator

2. 個人用ルールファイルを配置:

# 以下のファイルを独自の内容で作成:
~/.config/rune-orchestrator/AGENTS.md
~/.config/rune-orchestrator/SECURITY.md
~/.config/rune-orchestrator/CI-Error-Prevention.md

3. カスタムプロンプトを任意で作成:

mkdir -p ~/.config/rune-orchestrator/prompts
# カスタムプロンプトファイルをここに追加

使用方法

SPEC.mdファイル（またはdocs/SPEC.md）を含むGitリポジトリに移動:

cd /your/project  # SPEC.mdが必須
# specロックファイルを作成
shasum -a 256 SPEC.md | awk '{print $1}' > .spec.lock

# コマンドを実行
rune mop          # Master Orchestratorを実行
rune dev          # Dev Startを実行
rune cd-setup     # CD Setupを実行
rune release      # Release Publishを実行
rune custom ./my-prompt.txt  # カスタムプロンプトを実行

ランナーに追加引数を渡す:

rune mop -- --verbose
rune custom prompt.txt -- --model gpt-4-turbo

ファイル検索順序

SPEC.md (リポジトリ内で必須):

1. <repo-root>/SPEC.md
2. <repo-root>/docs/SPEC.md

AGENTS.md、SECURITY.md、CI-Error-Prevention.md:

1. <repo-root>/<file> (リポジトリ固有の上書き)
2. $HARVESTER_PATH/<file> (環境変数が設定されている場合)
3. ~/.config/rune-orchestrator/<file> (ユーザーデフォルト)

プロンプトファイル:

1. ~/.config/rune-orchestrator/prompts/<file>
2. ./.prompts/<file> (リポジトリローカル)
3. パッケージ組み込みプロンプト

環境変数

• RUNE_RUNNER: ランナー検出の上書き (codex, claude, openai, auto)
• RUNE_RUNNER_CMD: カスタムランナー実行可能ファイルへのパス
• RUNE_RUNNER_ARGS: カスタムランナーのデフォルト引数
• HARVESTER_PATH: コンテキストファイル検索用の追加ディレクトリ
• XDG_CONFIG_HOME: 設定ディレクトリベースの上書き (デフォルト: ~/.config)

終了コード

• 0: 成功
• 1: 一般エラー
• 10: Gitリポジトリ内ではない
• 12: SPEC.mdハッシュが.spec.lockと不一致
• 13: AIランナーが見つからない
• 14: 必須コンテキストファイルが欠落

セキュリティ

• シークレットの読み取りや送信はなし
• ネットワーク接続なし
• テレメトリ収集なし
• 指定したランナーのみを起動
• SPEC.mdはSHA256検証でロック

ライセンス

MIT