Rho のインストール

Rhoは永続的なAIエージェントフレームワークです。tmuxで実行され、ハートビートでチェックイン、単一のbrain.jsonlファイルにメモリを蓄積し、ナレッジヴォルトを管理します。このスキルはRhoをスクラッチからインストールします。

前提条件: シェルコマンドを実行できるコーディングエージェント。それだけです。

インストールされるもの:

• システム依存関係 (Node.js 18+、npm、tmux、git)
• pi コーディングエージェント (rhoが拡張するランタイム)
• rho (エージェントフレームワーク)
• ~/.rho/ 内の設定ファイル (init.toml、packages.toml、brain.jsonl)

所要時間: 良好な接続環境で約5分。

パラメータ

• agent_name (オプション、デフォルト: rho): ~/.rho/init.toml に書き込まれる名前。
• heartbeat_interval (オプション、デフォルト: 30m): エージェントがチェックインする頻度。[settings.heartbeat].interval に書き込まれます。

ステップ

1. 環境の検出

OS、シェル、依存関係のバージョンを表示します。これによってインストール経路が決定されます。

制約:

• OS + シェル + ノードバージョン (存在する場合) を表示する必要があります。
• $TERMUX_VERSION が設定されていない限り、Termuxと仮定してはいけません。

uname -a
printf "SHELL=%s\n" "$SHELL"
command -v node >/dev/null && node -v || echo "node: missing"
command -v npm  >/dev/null && npm -v  || echo "npm: missing"
command -v tmux >/dev/null && tmux -V || echo "tmux: missing"
command -v git  >/dev/null && git --version || echo "git: missing"
command -v pi   >/dev/null && pi --version || echo "pi: missing"
command -v rho  >/dev/null && rho --version || echo "rho: missing"

2. システム依存関係のインストール

制約:

• Node.js >= 18、npm、tmux、gitを確保する必要があります。
• プラットフォームを検出し、正しいパッケージマネージャーを使用する必要があります。
• 盲目的に sudo apt install を実行してはいけません。まずパッケージマネージャーを検出してください。

Android / Termux

pkg update -y
pkg install -y nodejs-lts tmux git

macOS

brew install node tmux git

Linux

パッケージマネージャーを検出します:

ディストロ	コマンド
NixOS	environment.systemPackages に追加するか、nix-shell -p nodejs tmux git を実行
Debian/Ubuntu	sudo apt update && sudo apt install -y nodejs npm tmux git
Arch	sudo pacman -S nodejs npm tmux git
Fedora	sudo dnf install nodejs npm tmux git

Node.jsバージョンが18未満の場合、NodeSourceまたはnvmを使用してください。

3. piコーディングエージェントのインストール

piはrhoが拡張するランタイムです。グローバルにインストールします。

制約:

• command -v pi が失敗する場合、piをグローバルにインストールする必要があります。
• インストール成功を検証する必要があります。

command -v pi >/dev/null || npm install -g @mariozechner/pi-coding-agent
pi --version

4. rhoのインストール

リポジトリをクローンしてインストーラーを実行します。インストーラーは設定のブートストラップ、CLIセットアップ、ブレイン初期化を処理します。

制約:

• ~/.rho/project にクローンする必要があります (デフォルトパス)。
• リポジトリが既に存在する場合はクローンしてはいけません (代わりにpullしてください)。
• リポジトリディレクトリ内から install.sh を実行する必要があります。

if [ -d ~/.rho/project/.git ]; then
  echo "Rho repo exists, pulling latest..."
  cd ~/.rho/project && git pull --ff-only
else
  git clone https://github.com/mikeyobrien/rho.git ~/.rho/project
fi

cd ~/.rho/project && bash install.sh

インストーラーは以下を実行します:

1. プラットフォームを検出
2. 残りの依存関係をチェック/インストール
3. プロジェクトのNodedepsをインストール
4. PATHに rho CLIをセットアップ
5. rho init を実行 (~/.rho/init.toml、~/.rho/packages.toml、brain.jsonlのデフォルト値を生成)
6. rho sync を実行 (設定からpiの settings.json を書き込み)

5. ハートビート間隔の設定 (オプション)

ユーザーがデフォルト以外の間隔をリクエストした場合、~/.rho/init.toml を編集します:

# [settings.heartbeat] セクションを見つけて間隔を設定
sed -i 's/interval = "30m"/interval = "'"${HEARTBEAT_INTERVAL}"'"/' ~/.rho/init.toml
rho sync

6. インストールの検証

制約:

• rho doctor を実行して、エラーを報告する必要があります。
• doctorがエラーを報告する場合、成功を宣言してはいけません。

rho doctor

7. 認証

制約:

• ユーザーに rho login を実行してLLMプロバイダーをセットアップするよう指示する必要があります。
• 自動的に rho login を実行してはいけません (インタラクティブです)。

ユーザーに以下を伝えます:

rho login を実行してLLMプロバイダー (Anthropic、OpenAIなど) で認証します。これはインタラクティブです。APIキーを提供するか、ブラウザ経由でログインする必要があります。

8. rhoの起動 (オプション)

制約:

• バックグラウンドプロセスを開始する前に、ユーザーに確認する必要があります。

rho

これは必要に応じてデーモンを起動し、tmuxセッションに接続します。

9. インストール後のオリエンテーション

以下の基本情報をユーザーと共有します:

主要ファイル:

• ~/.rho/init.toml — メイン設定 (Doom形式: モジュール、設定)
• ~/.rho/packages.toml — サードパーティpiパッケージ
• ~/.rho/brain/brain.jsonl — すべてのメモリの唯一の情報源 (動作、学習、好み、タスク、リマインダー)

メモリシステム:

• /brain または brain action=list — メモリ統計を表示
• brain action=add type=learning text="..." — 学習を追加
• brain action=add type=preference text="..." category=Code — 好みを追加
• brain action=add type=task description="..." priority=high — タスクを追加
• brain action=add type=reminder text="..." cadence={kind:"daily",at:"08:00"} — リマインダーを追加
• memory-consolidate — 統合を実行 (古いエントリを減衰させ、最後の統合以降のセッションをマイニング)

CLI基本:

• rho — 起動して接続
• rho status — デーモンとモジュールの状態を表示
• rho doctor — ヘルスチェック
• rho trigger — 即座にハートビートを強制
• rho stop — デーモンを停止
• rho upgrade — rhoを更新して新しいモジュールを同期

セッション内:

• /rho status — ハートビート状態
• /rho now — チェックインを強制
• /rho interval 30m — チェックイン間隔を設定

tmux基本 (未経験の場合):

• デタッチ: Ctrl-b d
• セッション一覧: tmux -L rho ls
• アタッチ: tmux -L rho attach -t rho

トラブルシューティング

問題	解決策
rho sync がpiがないと言う	npm install -g @mariozechner/pi-coding-agent
rho doctor が設定が同期していないと表示	rho sync
インストール後に rho が見つからない	~/.local/bin をPATHに追加
tmuxがない	プラットフォームのパッケージマネージャーでインストール
Node.js < 18	nvmまたはNodeSourceでアップグレード
install.sh がNixOSで失敗	依存関係はaptではなくnix設定にある必要があります