install-rho

Files (200)

• detailed-design.md · .agents/planning/2026-02-08-doom-style-config/design/
• idea-honing.md · .agents/planning/2026-02-08-doom-style-config/
• agent-config-patterns.md · .agents/planning/2026-02-08-doom-style-config/research/
• agent-sops-format.md · .agents/planning/2026-02-08-doom-style-config/research/
• doom-emacs-architecture.md · .agents/planning/2026-02-08-doom-style-config/research/
• module-registry.md · .agents/planning/2026-02-08-doom-style-config/research/
• pi-package-filtering.md · .agents/planning/2026-02-08-doom-style-config/research/
• toml-libraries.md · .agents/planning/2026-02-08-doom-style-config/research/
• rough-idea.md · .agents/planning/2026-02-08-doom-style-config/
• detailed-design.md · .agents/planning/2026-02-18-rho-web-multi-session/design/
• idea-honing.md · .agents/planning/2026-02-18-rho-web-multi-session/
• plan.md · .agents/planning/2026-02-18-rho-web-multi-session/implementation/
• 01-current-rho-web-multi-session-readiness.md · .agents/planning/2026-02-18-rho-web-multi-session/research/
• 02-mobile-browser-runtime-constraints.md · .agents/planning/2026-02-18-rho-web-multi-session/research/
• 03-v1-mobile-first-ux-and-state-model.md · .agents/planning/2026-02-18-rho-web-multi-session/research/
• 04-poc-acceptance-matrix.md · .agents/planning/2026-02-18-rho-web-multi-session/research/
• rough-idea.md · .agents/planning/2026-02-18-rho-web-multi-session/
• detailed-design.md · .agents/planning/2026-02-21-rho-capacitor-native-app/design/
• idea-honing.md · .agents/planning/2026-02-21-rho-capacitor-native-app/
• build-context.md · .agents/planning/2026-02-21-rho-capacitor-native-app/implementation/
• build-log.md · .agents/planning/2026-02-21-rho-capacitor-native-app/implementation/
• build-report.md · .agents/planning/2026-02-21-rho-capacitor-native-app/implementation/
• plan.md · .agents/planning/2026-02-21-rho-capacitor-native-app/implementation/
• android-networking-and-release-readiness.md · .agents/planning/2026-02-21-rho-capacitor-native-app/research/
• capacitor-security-and-session-patterns.md · .agents/planning/2026-02-21-rho-capacitor-native-app/research/
• dynamic-host-architecture-spike.md · .agents/planning/2026-02-21-rho-capacitor-native-app/research/
• rho-web-baseline-and-gaps.md · .agents/planning/2026-02-21-rho-capacitor-native-app/research/
• risk-register-and-mitigation-plan.md · .agents/planning/2026-02-21-rho-capacitor-native-app/research/
• rough-idea.md · .agents/planning/2026-02-21-rho-capacitor-native-app/
• summary.md · .agents/planning/2026-02-21-rho-capacitor-native-app/
• detailed-design.md · .agents/planning/2026-03-08-pi-liveview-web-frontend/design/
• idea-honing.md · .agents/planning/2026-03-08-pi-liveview-web-frontend/
• plan.md · .agents/planning/2026-03-08-pi-liveview-web-frontend/implementation/
• README.md · .agents/planning/2026-03-08-pi-liveview-web-frontend/research/
• codex-desktop-benchmark.md · .agents/planning/2026-03-08-pi-liveview-web-frontend/research/
• liveview-pwa-patterns.md · .agents/planning/2026-03-08-pi-liveview-web-frontend/research/
• multimodal-attachments.md · .agents/planning/2026-03-08-pi-liveview-web-frontend/research/
• pi-integration-surface.md · .agents/planning/2026-03-08-pi-liveview-web-frontend/research/
• terminal-embedding-libghostty.md · .agents/planning/2026-03-08-pi-liveview-web-frontend/research/
• rough-idea.md · .agents/planning/2026-03-08-pi-liveview-web-frontend/
• summary.md · .agents/planning/2026-03-08-pi-liveview-web-frontend/
• fork-chat-ux.md · .agents/planning/web-ui-polish/
• plan.md · .agents/planning/web-ui-polish/
• context.md · .agents/scratchpad/2026-02-13-telegram-multi-instance-poll-conflicts-fix/task-01-implement-telegram-poll-leader-election/
• plan.md · .agents/scratchpad/2026-02-13-telegram-multi-instance-poll-conflicts-fix/task-01-implement-telegram-poll-leader-election/
• progress.md · .agents/scratchpad/2026-02-13-telegram-multi-instance-poll-conflicts-fix/task-01-implement-telegram-poll-leader-election/
• context.md · .agents/scratchpad/2026-02-13-telegram-multi-instance-poll-conflicts-fix/task-02-implement-follower-safe-telegram-operator-flow-and-observability/
• plan.md · .agents/scratchpad/2026-02-13-telegram-multi-instance-poll-conflicts-fix/task-02-implement-follower-safe-telegram-operator-flow-and-observability/
• progress.md · .agents/scratchpad/2026-02-13-telegram-multi-instance-poll-conflicts-fix/task-02-implement-follower-safe-telegram-operator-flow-and-observability/
• .last_commit · .agents/summary/
• architecture.md · .agents/summary/
• codebase_info.md · .agents/summary/
• components.md · .agents/summary/
• data_models.md · .agents/summary/
• dependencies.md · .agents/summary/
• index.md · .agents/summary/
• interfaces.md · .agents/summary/
• recent_changes.md · .agents/summary/
• review_notes.md · .agents/summary/
• workflows.md · .agents/summary/
• …and 140 more

SKILL.md (first lines)

# Install Rho

Rho is a persistent AI agent framework. It runs in tmux, checks in on a heartbeat, accumulates memory in a single brain.jsonl file, and manages a knowledge vault. This skill installs it from scratch.

**Prerequisites:** A coding agent that can run shell commands. That's it.

**What gets installed:**
- System deps (Node.js 18+, npm, tmux, git)
- [pi coding agent](https://github.com/badlogic/pi-mono) (the runtime rho extends)
- [rho](https://github.com/mikeyobrien/rho) (the agent framework)
- Config files in `~/.rho/` (init.toml, packages.toml, brain.jsonl)

**Time:** ~5 minutes on a decent connection.

## Parameters

- **agent_name** (optional, default: `rho`): Name written into `~/.rho/init.toml`.
- **heartbeat_interval** (optional, default: `30m`): How often the agent checks in. Written to `[settings.heartbeat].interval`.

## Steps

### 1. Detect environment

Print OS, shell, and dependency versions. This determines the install path.

**Constraints:**
- You MUST print OS + shell + node version (if present).
- You MUST NOT assume Termux unless `$TERMUX_VERSION` is set.

```bash
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. Install system dependencies

**Constraints:**
- You MUST ensure: Node.js >= 18, npm, tmux, git.
- You MUST detect the platform and use the correct package manager.
- You MUST NOT blindly run `sudo apt install` — detect the package manager first.

#### Android / Termux

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

#### macOS

```bash
brew install node tmux git
```

#### Linux

Detect the package manager:

| Distro | Command |
|--------|---------|
| NixOS | Add to `environment.systemPackages` or `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` |

If Node.js version is < 18, use [NodeSource](https://github.com/nodesource/distributions) or nvm.

### 3. Install pi coding agent

pi is the runtime that rho extends. Install it globally.

**Constraints:**
- You MUST install pi globally if `command -v pi` fails.
- You MUST verify the install succeeded.

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

### 4. Install rho

Clone the repo and run the installer. The installer handles config bootstrapping, CLI setup, and brain initialization.

**Constraints:**
- You MUST clone to `~/.rho/project` (the default path).
- You MUST NOT clone if the repo already exists (pull instead).
- You MUST run `install.sh` from within the repo directory.

```bash
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
```

The installer will:
1. Detect your platform
2. Check/install remaining dependencies
3. Install Node deps for the project
4. Set up the `rho` CLI on your PATH
5. Run `rho init` (generates `~/.rho/init.toml`, `~/.rho/packages.toml`, and brain.jsonl defaults)
6. Run `rho sync` (writes pi's `settings.json` from your config)

### 5. Configure heartbeat interval (optional)

If the user requested a non-default interval, edit `~/.rho/init.toml`:

```bash

From mikeyobrien/rho, MIT.

More from mikeyobrien/rho