install-rho

Category: Tools & Productivity | Uploader: mikeyobrien | Downloads: 0 | Version: v1.0（Latest）

Install and configure Rho from scratch (Doom-style init.toml + sync). Only prereq: a coding agent that can run shell commands.

Changelog: Source: GitHub https://github.com/mikeyobrien/rho

Directory Structure

Current level: Root

📁 .agents/
- 📁 planning/
  - 📁 2026-02-08-doom-style-config/
    
    📁 design/
    
    📄 detailed-design.md 21.0 KB
    
    📁 research/
    
    📄 agent-config-patterns.md 2.8 KB
    
    📄 agent-sops-format.md 2.4 KB
    
    📄 doom-emacs-architecture.md 3.0 KB
    
    📄 module-registry.md 3.0 KB
    
    📄 pi-package-filtering.md 2.5 KB
    
    📄 toml-libraries.md 2.4 KB
    
    📄 idea-honing.md 21.6 KB
    
    📄 rough-idea.md 806 B
  - 📁 2026-02-18-rho-web-multi-session/
    
    📁 design/
    
    📄 detailed-design.md 10.4 KB
    
    📁 implementation/
    
    📄 plan.md 10.9 KB
    
    📁 research/
    
    📄 01-current-rho-web-multi-session-readiness.md 4.0 KB
    
    📄 02-mobile-browser-runtime-constraints.md 3.2 KB
    
    📄 03-v1-mobile-first-ux-and-state-model.md 3.2 KB
    
    📄 04-poc-acceptance-matrix.md 3.3 KB
    
    📄 idea-honing.md 6.2 KB
    
    📄 rough-idea.md 1.5 KB
  - 📁 2026-02-21-rho-capacitor-native-app/
    
    📁 design/
    
    📄 detailed-design.md 13.1 KB
    
    📁 implementation/
    
    📄 build-context.md 2.9 KB
    
    📄 build-log.md 8.1 KB
    
    📄 build-report.md 3.5 KB
    
    📄 plan.md 9.6 KB
    
    📁 research/
    
    📄 android-networking-and-release-readiness.md 3.2 KB
    
    📄 capacitor-security-and-session-patterns.md 3.5 KB
    
    📄 dynamic-host-architecture-spike.md 4.8 KB
    
    📄 rho-web-baseline-and-gaps.md 3.7 KB
    
    📄 risk-register-and-mitigation-plan.md 3.2 KB
    
    📄 idea-honing.md 6.2 KB
    
    📄 rough-idea.md 220 B
    
    📄 summary.md 3.0 KB
  - 📁 web-ui-polish/
    
    📄 fork-chat-ux.md 6.1 KB
    
    📄 plan.md 4.4 KB
- 📁 scratchpad/
  - 📁 2026-02-13-telegram-multi-instance-poll-conflicts-fix/
    
    📁 task-01-implement-telegram-poll-leader-election/
    
    📄 context.md 4.1 KB
    
    📄 plan.md 3.5 KB
    
    📄 progress.md 2.9 KB
    
    📁 task-02-implement-follower-safe-telegram-operator-flow-and-observability/
    
    📄 context.md 4.4 KB
    
    📄 plan.md 3.4 KB
    
    📄 progress.md 3.0 KB
- 📁 summary/
  - 📄 .last_commit 41 B
  - 📄 architecture.md 1.6 KB
  - 📄 codebase_info.md 1.4 KB
  - 📄 components.md 2.1 KB
  - 📄 data_models.md 1.6 KB
  - 📄 dependencies.md 1.1 KB
  - 📄 index.md 1.9 KB
  - 📄 interfaces.md 1.6 KB
  - 📄 recent_changes.md 533 B
  - 📄 review_notes.md 1.3 KB
  - 📄 workflows.md 1.5 KB
- 📁 tasks/
  - 📁 2026-02-23-android-background-reliability/
    
    📄 task-01-orphan-policy-mitigation.code-task.md 4.5 KB
    
    📄 task-02-live-mode-native-no-firebase-reliability.code-task.md 6.9 KB
  - 📁 rho-web-perf/
    
    📄 no-build-perf-sweep.code-task.md 6.3 KB
  - 📁 rho-web-tool-rendering/
    
    📄 task-01-tool-semantic-parser.code-task.md 4.9 KB
    
    📄 task-02-smart-collapsed-state.code-task.md 4.7 KB
    
    📄 task-03-edit-write-semantic-view.code-task.md 4.3 KB
    
    📄 task-04-read-tool-semantic-view.code-task.md 4.1 KB
    
    📄 task-05-bash-output-improvements.code-task.md 4.3 KB
    
    📄 task-06-brain-vault-compact-rendering.code-task.md 4.3 KB
  - 📄 2026-02-16-telegram-fork-timeout-into-jobs.code-task.md 6.2 KB
  - 📄 2026-02-16-telegram-grammy-only-cleanup.code-task.md 4.1 KB
  - 📄 2026-02-20-footer-git-context-picker.code-task.md 7.2 KB
  - 📄 2026-02-22-android-background-streaming-reliability.code-task.md 9.2 KB
📁 .github/
- 📁 workflows/
  - 📄 android-release.yml 6.5 KB
  - 📄 e2e.yml 359 B
  - 📄 mobile-sanity.yml 655 B
  - 📄 parity-gate.yml 1.7 KB
  - 📄 publish.yml 866 B
- 📄 FUNDING.yml 22 B
📁 apt/
- 📄 Packages 467 B
- 📄 Packages.gz 364 B
- 📄 rho_0.0.3_all.deb 25.3 KB
📁 brain/
- 📄 brain.jsonl.default 2.7 KB
📁 cli/
- 📁 commands/
  - 📄 bootstrap.ts 20.9 KB
  - 📄 config.ts 2.1 KB
  - 📄 doctor.ts 8.5 KB
  - 📄 init.ts 7.2 KB
  - 📄 login.ts 4.3 KB
  - 📄 logs.ts 4.5 KB
  - 📄 skills.ts 12.6 KB
  - 📄 start.ts 12.7 KB
  - 📄 status.ts 6.4 KB
  - 📄 stop.ts 3.5 KB
  - 📄 sync.ts 17.3 KB
  - 📄 telegram.ts 24.2 KB
  - 📄 trigger.ts 3.0 KB
  - 📄 upgrade.ts 8.2 KB
  - 📄 web.ts 12.7 KB
- 📄 config.ts 6.7 KB
- 📄 daemon-core.ts 6.6 KB
- 📄 doctor-core.ts 9.2 KB
- 📄 index.ts 4.2 KB
- 📄 init-core.ts 7.8 KB
- 📄 registry.ts 5.2 KB
- 📄 rho.mjs 100 B
- 📄 sync-core.ts 8.4 KB
- 📄 telegramd.mjs 104 B
- 📄 telegramd.ts 269 B
📁 configs/
- 📄 tmux-rho.conf 1.9 KB
📁 docs/
- 📁 plans/
  - 📄 chat-js-refactor-plan.md 4.9 KB
  - 📄 review-deferred-inbox-plan.md 6.6 KB
- 📄 android-release-runbook.md 2.7 KB
- 📄 bootstrap-pr-plan.md 1.3 KB
- 📄 bootstrapping-brain.md 1.9 KB
- 📄 brain.md 19.5 KB
- 📄 configuration.md 8.2 KB
- 📄 demo.cast 172.2 KB
- 📄 demo.gif 633.9 KB
- 📄 demo.md 1.4 KB
- 📄 email-demo.cast 521.4 KB
- 📄 email-demo.gif 1.1 MB
- 📄 iphone-setup.md 3.0 KB
- 📄 logo.png 273.8 KB
- 📄 meta-prompt-design.md 3.4 KB
- 📄 nix-android-dev-shell.md 693 B
- 📄 pr-description-draft.md 2.2 KB
- 📄 release-notes-draft.md 2.8 KB
- 📄 review.md 3.1 KB
- 📄 skills.md 2.1 KB
- 📄 slash-command-contract.md 3.0 KB
- 📄 tasker-profiles.md 5.6 KB
- 📄 tasker-setup.md 7.2 KB
- 📄 telegram.md 5.0 KB
- 📄 termux-config.md 3.6 KB
- 📄 vps-setup.md 2.2 KB
- 📄 web-ui-hero.jpg 434.5 KB
📁 extensions/
- 📁 brave-search/
  - 📄 index.ts 3.7 KB
- 📁 email/
  - 📄 index.ts 31.0 KB
- 📁 lib/
  - 📄 auto-memory-model.ts 3.6 KB
  - 📄 brain-bootstrap-schema.ts 5.0 KB
  - 📄 brain-bootstrap-state.ts 3.4 KB
  - 📄 brain-migration.ts 10.7 KB
  - 📄 brain-store.ts 23.2 KB
  - 📄 brain-tool.ts 21.3 KB
  - 📄 file-lock.ts 5.9 KB
  - 📄 lease-lock.ts 8.7 KB
  - 📄 memory-settings.ts 8.6 KB
  - 📄 mod.ts 2.1 KB
  - 📄 vault-lib.ts 2.6 KB
  - 📄 vault-search-lib.ts 15.7 KB
- 📁 memory-viewer/
  - 📄 index.ts 17.7 KB
- 📁 review/
  - 📁 web/
    
    📁 css/
    
    📄 review.css 19.5 KB
    
    📁 js/
    
    📄 review.js 8.5 KB
    
    📄 index.html 7.4 KB
  - 📄 .gitignore 14 B
  - 📄 command.test.ts 1.5 KB
  - 📄 files.test.ts 2.4 KB
  - 📄 files.ts 3.5 KB
  - 📄 format.test.ts 4.5 KB
  - 📄 format.ts 1.1 KB
  - 📄 git-tracker.ts 2.1 KB
  - 📄 index.ts 10.2 KB
  - 📄 package-lock.json 9.0 KB
  - 📄 package.json 161 B
  - 📄 server.test.ts 14.4 KB
  - 📄 server.ts 11.0 KB
  - 📄 tui.test.ts 12.9 KB
  - 📄 tui.ts 26.2 KB
  - 📄 web.test.ts 13.4 KB
- 📁 rho/
  - 📁 bootstrap/
    
    📄 slash-bootstrap.ts 7.9 KB
  - 📄 index.ts 130.9 KB
  - 📄 tasks-core.ts 7.9 KB
- 📁 telegram/
  - 📄 api.ts 3.1 KB
  - 📄 check-trigger.ts 3.9 KB
  - 📄 index.ts 19.7 KB
  - 📄 jobs.ts 4.6 KB
  - 📄 lib.ts 7.2 KB
  - 📄 log.ts 2.2 KB
  - 📄 operator-config.ts 1.6 KB
  - 📄 outbound.ts 3.7 KB
  - 📄 pending-approvals.ts 5.2 KB
  - 📄 poll-leadership.ts 3.0 KB
  - 📄 router.ts 5.9 KB
  - 📄 rpc.ts 17.5 KB
  - 📄 session-map.ts 3.2 KB
  - 📄 slash-contract.ts 6.6 KB
  - 📄 status.ts 3.0 KB
  - 📄 stt.ts 5.0 KB
  - 📄 worker-lock.ts 2.9 KB
  - 📄 worker-runtime.ts 65.1 KB
  - 📄 worker.ts 4.3 KB
- 📁 usage-bars/
  - 📄 index.ts 7.4 KB
- 📁 vault-search/
  - 📄 index.ts 4.1 KB
- 📁 x-search/
  - 📄 index.ts 8.3 KB
📁 features/
- 📄 brain-bootstrap.feature 2.4 KB
- 📄 iphone-termius-support.feature 2.3 KB
- 📄 rho-login.feature 5.4 KB
- 📄 rho-run-command.feature 6.0 KB
- 📄 session-digest-tool.feature 796 B
- 📄 smart-heartbeat-routing.feature 6.1 KB
- 📄 tasks-command.feature 6.9 KB
- 📄 tasks-overlay.feature 2.3 KB
- 📄 vault-browse-overlay.feature 1.9 KB
- 📄 x-posting-extension.feature 2.4 KB
📁 mobile/
- 📁 rho-android/
  - 📁 android/
    
    📁 app/
    
    📁 src/
    
    📁 androidTest/
    
    📁 java/
    
    📁 com/
    
    📁 getcapacitor/
    
    📁 myapp/
    
    📄 ExampleInstrumentedTest.java 774 B
    
    📁 main/
    
    📁 java/
    
    📁 dev/
    
    📁 rhobot/
    
    📁 rhoandroid/
    
    📄 LiveModeContextStore.java 3.9 KB
    
    📄 LiveModePlugin.java 7.5 KB
    
    📄 LiveModeService.java 9.7 KB
    
    📄 MainActivity.java 3.0 KB
    
    📄 RhoNotificationChannel.java 1.5 KB
    
    📁 res/
    
    📁 drawable/
    
    📄 ic_launcher_background.xml 5.5 KB
    
    📄 splash.png 3.9 KB
    
    📁 drawable-land-hdpi/
    
    📄 splash.png 7.5 KB
    
    📁 drawable-land-mdpi/
    
    📄 splash.png 3.9 KB
    
    📁 drawable-land-xhdpi/
    
    📄 splash.png 9.0 KB
    
    📁 drawable-land-xxhdpi/
    
    📄 splash.png 13.7 KB
    
    📁 drawable-land-xxxhdpi/
    
    📄 splash.png 17.3 KB
    
    📁 drawable-port-hdpi/
    
    📄 splash.png 7.7 KB
    
    📁 drawable-port-mdpi/
    
    📄 splash.png 4.0 KB
    
    📁 drawable-port-xhdpi/
    
    📄 splash.png 9.6 KB
    
    📁 drawable-port-xxhdpi/
    
    📄 splash.png 13.0 KB
    
    📁 drawable-port-xxxhdpi/
    
    📄 splash.png 17.1 KB
    
    📁 drawable-v24/
    
    📄 ic_launcher_foreground.xml 1.8 KB
    
    📁 layout/
    
    📄 activity_main.xml 535 B
    
    📁 mipmap-anydpi-v26/
    
    📄 ic_launcher.xml 265 B
    
    📄 ic_launcher_round.xml 265 B
    
    📁 mipmap-hdpi/
    
    📄 ic_launcher.png 1.3 KB
    
    📄 ic_launcher_foreground.png 3.0 KB
    
    📄 ic_launcher_round.png 1.3 KB
    
    📁 mipmap-mdpi/
    
    📄 ic_launcher.png 871 B
    
    📄 ic_launcher_foreground.png 1.9 KB
    
    📄 ic_launcher_round.png 871 B
    
    📁 mipmap-xhdpi/
    
    📄 ic_launcher.png 1.7 KB
    
    📄 ic_launcher_foreground.png 4.1 KB
    
    📄 ic_launcher_round.png 1.7 KB
    
    📁 mipmap-xxhdpi/
    
    📄 ic_launcher.png 2.6 KB
    
    📄 ic_launcher_foreground.png 6.7 KB
    
    📄 ic_launcher_round.png 2.6 KB
    
    📁 mipmap-xxxhdpi/
    
    📄 ic_launcher.png 3.6 KB
    
    📄 ic_launcher_foreground.png 9.3 KB
    
    📄 ic_launcher_round.png 3.6 KB
    
    📁 values/
    
    📄 ic_launcher_background.xml 120 B
    
    📄 strings.xml 288 B
    
    📄 styles.xml 823 B
    
    📁 xml/
    
    📄 file_paths.xml 213 B
    
    📄 network_security_config.xml 293 B
    
    📄 AndroidManifest.xml 2.7 KB
    
    📁 test/
    
    📁 java/
    
    📁 com/
    
    📁 getcapacitor/
    
    📁 myapp/
    
    📄 ExampleUnitTest.java 402 B
    
    📄 .gitignore 26 B
    
    📄 build.gradle 2.3 KB
    
    📄 capacitor.build.gradle 485 B
    
    📄 proguard-rules.pro 751 B
    
    📁 gradle/
    
    📁 wrapper/
    
    📄 gradle-wrapper.jar 61.9 KB
    
    📄 gradle-wrapper.properties 252 B
    
    📄 .gitignore 1.8 KB
    
    📄 build.gradle 579 B
    
    📄 capacitor.settings.gradle 516 B
    
    📄 gradle.properties 987 B
    
    📄 gradlew 8.3 KB
    
    📄 gradlew.bat 2.8 KB
    
    📄 settings.gradle 208 B
    
    📄 variables.gradle 496 B
  - 📁 src/
    
    📁 models/
    
    📄 profile.ts 946 B
    
    📁 storage/
    
    📄 profile-repository.ts 3.6 KB
    
    📄 secure-token-store.ts 2.3 KB
    
    📄 app-lifecycle.ts 4.3 KB
    
    📄 connection-coordinator.ts 4.6 KB
    
    📄 http-policy.ts 1.5 KB
    
    📄 index.ts 12.7 KB
    
    📄 live-mode-controller.ts 8.9 KB
    
    📄 mapConnectionErrorToMessage.ts 734 B
    
    📄 replay-resume.ts 6.2 KB
    
    📄 session-monitor.ts 2.8 KB
  - 📁 tests/
    
    📄 android-strings.test.ts 509 B
    
    📄 app-lifecycle.test.ts 10.6 KB
    
    📄 capacitor-config.test.ts 162 B
    
    📄 connection-coordinator.test.ts 7.8 KB
    
    📄 http-policy.test.ts 1.5 KB
    
    📄 live-mode-controller.test.ts 5.8 KB
    
    📄 mapConnectionErrorToMessage.test.ts 1.6 KB
    
    📄 profile-validation.test.ts 1.5 KB
    
    📄 replay-resume.test.ts 3.4 KB
    
    📄 session-monitor.test.ts 3.8 KB
    
    📄 storage.test.ts 4.5 KB
  - 📁 www/
    
    📁 css/
    
    📄 profile-picker.css 6.0 KB
    
    📄 rho-web-style.css 65.3 KB
    
    📁 js/
    
    📁 models/
    
    📄 profile.js 812 B
    
    📁 storage/
    
    📄 profile-repository.js 3.7 KB
    
    📄 secure-token-store.js 2.1 KB
    
    📄 app-lifecycle.js 3.8 KB
    
    📄 connection-coordinator.js 4.7 KB
    
    📄 http-policy.js 1.3 KB
    
    📄 index.js 12.8 KB
    
    📄 live-mode-controller.js 8.0 KB
    
    📄 mapConnectionErrorToMessage.js 774 B
    
    📄 replay-resume.js 6.1 KB
    
    📄 session-monitor.js 2.9 KB
    
    📄 index.html 4.4 KB
  - 📄 .gitignore 74 B
  - 📄 capacitor.config.ts 321 B
  - 📄 jest.config.js 428 B
  - 📄 package-lock.json 199.2 KB
  - 📄 package.json 802 B
  - 📄 tsconfig.json 281 B
📁 platforms/
- 📁 android/
  - 📁 extensions/
    
    📄 tasker.ts 27.5 KB
  - 📁 scripts/
    
    📁 bin/
    
    📄 stt 492 B
    
    📄 stt-send 559 B
  - 📁 skills/
    
    📁 clipboard/
    
    📄 SKILL.md 409 B
    
    📁 contacts/
    
    📄 SKILL.md 1015 B
    
    📁 device/
    
    📄 SKILL.md 1.6 KB
    
    📁 dialog/
    
    📄 SKILL.md 1.4 KB
    
    📁 location/
    
    📄 SKILL.md 900 B
    
    📁 media/
    
    📄 SKILL.md 1.1 KB
    
    📁 notification/
    
    📄 SKILL.md 1.2 KB
    
    📁 open-url/
    
    📄 SKILL.md 1.9 KB
    
    📁 sms/
    
    📄 SKILL.md 999 B
    
    📁 stt/
    
    📄 SKILL.md 597 B
    
    📁 tasker-xml/
    
    📄 SKILL.md 11.9 KB
    
    📁 tts/
    
    📄 SKILL.md 643 B
- 📁 linux/
  - 📁 skills/
    
    📁 clipboard/
    
    📄 SKILL.md 1.3 KB
    
    📁 notification/
    
    📄 SKILL.md 1.4 KB
    
    📁 open-url/
    
    📄 SKILL.md 1.2 KB
    
    📁 tts/
    
    📄 SKILL.md 1.6 KB
  - 📄 setup.sh 2.6 KB
- 📁 macos/
  - 📁 skills/
    
    📁 clipboard/
    
    📄 SKILL.md 502 B
    
    📁 notification/
    
    📄 SKILL.md 1.2 KB
    
    📁 open-url/
    
    📄 SKILL.md 573 B
    
    📁 tts/
    
    📄 SKILL.md 706 B
  - 📄 setup.sh 1.3 KB
📁 scripts/
- 📄 check-line-limit.sh 813 B
- 📄 pre-commit.sh 687 B
- 📄 telegram-smoke.ts 1.0 KB
📁 skills/
- 📁 auto-memory/
  - 📄 SKILL.md 8.0 KB
- 📁 code-assist/
  - 📄 SKILL.md 26.5 KB
- 📁 code-task-generator/
  - 📄 SKILL.md 13.1 KB
- 📁 codebase-summary/
  - 📄 SKILL.md 14.6 KB
- 📁 create-sop/
  - 📄 SKILL.md 2.4 KB
- 📁 eval/
  - 📄 SKILL.md 38.0 KB
- 📁 memory-consolidate/
  - 📄 SKILL.md 5.2 KB
- 📁 pdd/
  - 📄 SKILL.md 19.0 KB
- 📁 pdd-build/
  - 📄 SKILL.md 10.5 KB
- 📁 release-changelog/
  - 📄 SKILL.md 5.3 KB
- 📁 rho-cloud-email/
  - 📄 SKILL.md 10.3 KB
- 📁 rho-cloud-onboard/
  - 📁 scripts/
    
    📄 send-test-email.py 1.5 KB
  - 📄 SKILL.md 5.3 KB
- 📁 session-search/
  - 📄 SKILL.md 2.2 KB
- 📁 small-improvement/
  - 📄 SKILL.md 14.4 KB
- 📁 update-pi/
  - 📄 SKILL.md 288 B
- 📁 vault-clean/
  - 📄 SKILL.md 3.3 KB
📁 specs/
- 📄 pi-native-extensions-execution-plan.md 12.7 KB
📁 tasker/
- 📄 Rho.prj.xml 36.7 KB
📁 templates/
- 📄 init.toml 6.4 KB
- 📄 packages.toml 730 B
📁 tests/
- 📁 e2e/
  - 📄 Dockerfile 1.3 KB
  - 📄 Dockerfile.npm 1.3 KB
  - 📄 Dockerfile.regressions 1.4 KB
  - 📄 Dockerfile.start-bug 1.1 KB
  - 📄 run.sh 2.1 KB
  - 📄 test-e2e.sh 12.3 KB
  - 📄 test-npm-install.sh 14.1 KB
  - 📄 test-regressions.sh 8.0 KB
  - 📄 test-start-bug.sh 3.1 KB
- 📁 playwriter/
  - 📄 web-multi-session-gates.ts 28.0 KB
- 📄 generate-synthetic-brain.ts 9.4 KB
- 📄 parity-checklist.md 4.3 KB
- 📄 test-android-release-workflow.ts 1.7 KB
- 📄 test-auto-memory-model.ts 6.3 KB
- 📄 test-bootstrap-command.ts 3.1 KB
- 📄 test-bootstrap-slash.ts 5.5 KB
- 📄 test-brain-bootstrap-schema.ts 3.1 KB
- 📄 test-brain-bootstrap-state.ts 2.8 KB
- 📄 test-brain-migration.ts 22.1 KB
- 📄 test-brain-prompt.ts 14.1 KB
- 📄 test-brain-store.ts 20.4 KB
- 📄 test-brain-tool.ts 21.9 KB
- 📄 test-cli.ts 6.0 KB
- 📄 test-config.ts 10.5 KB
- 📄 test-daemon.ts 15.2 KB
- 📄 test-doctor.ts 15.3 KB
- 📄 test-file-lock.ts 9.6 KB
- 📄 test-init.ts 11.5 KB
- 📄 test-iphone-docs.sh 2.0 KB
- 📄 test-lease-lock.ts 4.0 KB
- 📄 test-memory-consolidate.sh 10.6 KB
- 📄 test-memory-settings.ts 5.4 KB
- 📄 test-mobile-parity-smoke.ts 11.5 KB
- 📄 test-one-skill-system.ts 4.3 KB
- 📄 test-registry.ts 5.7 KB
- 📄 test-regressions.ts 10.9 KB
- 📄 test-review-deferred-flow.ts 7.0 KB
- 📄 test-review-panel.ts 5.4 KB
- 📄 test-review-store.ts 5.4 KB
- 📄 test-rho-login.sh 1.5 KB
- 📄 test-rpc-slash-notify-race.ts 8.3 KB
- 📄 test-slash-contract-parity.ts 3.9 KB
- 📄 test-sync.ts 21.1 KB
- 📄 test-tasks.ts 18.2 KB
- 📄 test-telegram-stt.ts 4.1 KB
- 📄 test-telegram-worker-lock.ts 3.9 KB
- 📄 test-telegram-worker-runtime.ts 64.0 KB
- 📄 test-telegram.ts 67.1 KB
- 📄 test-templates.ts 7.3 KB
- 📄 test-tmux-config.sh 2.0 KB
- 📄 test-vault-search.ts 2.8 KB
- 📄 test-vault.ts 24.4 KB
- 📄 test-web-chat-reconnect.ts 19.4 KB
- 📄 test-web-chat-restore-persistence.ts 11.2 KB
- 📄 test-web-chat-session-ordering.ts 5.2 KB
- 📄 test-web-chat-session-state.ts 10.6 KB
- 📄 test-web-chat-slash.ts 5.2 KB
- 📄 test-web-chat-ws-routing.ts 12.3 KB
- 📄 test-web-line-limit.ts 1.6 KB
- 📄 test-web-mobile-auth-gate.ts 4.4 KB
- 📄 test-web-mobile-auth.ts 8.6 KB
- 📄 test-web-mobile-live-mode-bridge.ts 7.8 KB
- 📄 test-web-rpc-health-watchdog.ts 3.5 KB
- 📄 test-web-rpc-live-mode-lease.ts 5.9 KB
- 📄 test-web-rpc-orphan-config.ts 10.1 KB
- 📄 test-web-rpc-orphan-smoke.ts 7.4 KB
- 📄 test-web-rpc-reconnect-smoke.ts 10.7 KB
- 📄 test-web-rpc-reliability.ts 4.7 KB
- 📄 test-web-rpc-sessions-api.ts 2.5 KB
- 📄 test-web-session-usage.ts 8.2 KB
📁 tmp/
- 📄 playwriter-screenshot-1770676991487-l3yq.jpg 10.0 KB
- 📄 playwriter-screenshot-1770681994229-oi3f.jpg 67.7 KB
- 📄 playwriter-screenshot-1770682003241-x2zc.jpg 32.6 KB
- 📄 playwriter-screenshot-1770682077622-mryx.jpg 35.4 KB
📁 web/
- 📁 public/
  - 📁 css/
    
    📄 review-panel.css 6.4 KB
    
    📄 style.css 65.3 KB
  - 📁 js/
    
    📁 chat/
    
    📄 chat-dialog-and-focus.js 2.6 KB
    
    📄 chat-git-context-picker.js 6.2 KB
    
    📄 chat-input-and-rpc-send.js 11.7 KB
    
    📄 chat-model-and-extension-ui.js 10.9 KB
    
    📄 chat-rpc-event-routing.js 12.8 KB
    
    📄 chat-session-actions.js 12.5 KB
    
    📄 chat-session-ui.js 13.2 KB
    
    📄 chat-slash-and-stats.js 11.5 KB
    
    📄 chat-streaming-parts.js 12.1 KB
    
    📄 constants-and-primitives.js 10.1 KB
    
    📄 index.js 13.2 KB
    
    📄 mobile-live-mode-bridge.js 4.5 KB
    
    📄 model-thinking-and-toast.js 2.0 KB
    
    📄 rendering-and-usage.js 11.9 KB
    
    📄 rpc-health-watchdog.js 1.7 KB
    
    📄 rpc-reconnect-runtime.js 6.0 KB
    
    📄 rpc-session-routing.js 3.9 KB
    
    📄 session-list-ordering.js 3.4 KB
    
    📄 session-restore-persistence.js 11.6 KB
    
    📄 session-ui-state.js 5.5 KB
    
    📄 tool-semantics.js 11.4 KB
    
    📄 app.js 2.4 KB
    
    📄 chat.js 177 B
    
    📄 config.js 2.7 KB
    
    📄 memory.js 8.2 KB
    
    📄 pull-to-refresh.js 4.5 KB
    
    📄 review-panel.js 9.4 KB
    
    📄 slash-contract.js 5.9 KB
  - 📁 review/
    
    📁 css/
    
    📄 review.css 18.4 KB
    
    📁 js/
    
    📄 review.js 14.7 KB
    
    📄 index.html 10.6 KB
  - 📄 favicon.svg 268 B
  - 📄 icon-192.png 543 B
  - 📄 icon-512.png 1.8 KB
  - 📄 index.html 71.8 KB
  - 📄 manifest.json 604 B
  - 📄 sw.js 1.1 KB
- 📄 config.ts 5.3 KB
- 📄 dev.ts 572 B
- 📄 file-watcher.ts 3.3 KB
- 📄 git-context-store.ts 5.0 KB
- 📄 review-store.ts 11.8 KB
- 📄 rpc-live-mode-lease.ts 2.7 KB
- 📄 rpc-manager.ts 8.4 KB
- 📄 rpc-reliability.ts 7.9 KB
- 📄 server-config-sessions-routes.ts 5.0 KB
- 📄 server-core.ts 11.9 KB
- 📄 server-git-context-routes.ts 1.7 KB
- 📄 server-git-routes.ts 12.2 KB
- 📄 server-mobile-auth-middleware.ts 1.2 KB
- 📄 server-mobile-auth-routes.ts 3.8 KB
- 📄 server-mobile-auth-state.ts 458 B
- 📄 server-review-routes.ts 9.4 KB
- 📄 server-rpc-live-mode-routes.ts 2.1 KB
- 📄 server-rpc-ws-routes.ts 4.7 KB
- 📄 server-static-routes.ts 4.0 KB
- 📄 server-tasks-memory-routes.ts 10.3 KB
- 📄 server-ui-events.ts 756 B
- 📄 server.ts 598 B
- 📄 session-reader-api.ts 6.1 KB
- 📄 session-reader-io.ts 3.8 KB
- 📄 session-reader-parse.ts 7.3 KB
- 📄 session-reader-types.ts 2.2 KB
- 📄 session-reader.ts 238 B
- 📄 task-api.ts 3.4 KB
📄 .dockerignore 75 B
📄 .gitignore 1.1 KB
📄 .npmignore 1.3 KB
📄 AGENTS.md 2.9 KB
📄 CHANGELOG.md 2.1 KB
📄 flake.lock 1.5 KB
📄 flake.nix 2.2 KB
📄 install.sh 10.1 KB
📄 LICENSE 1.0 KB
📄 package-lock.json 125.6 KB
📄 package.json 2.4 KB
📄 postinst 1.3 KB
📄 ralph-chat-fixes.yml 2.0 KB
📄 ralph-chat-ux.yml 4.3 KB
📄 ralph-polish.yml 3.6 KB
📄 ralph-web-ui.yml 5.2 KB
📄 ralph.yml 14.2 KB
📄 README.md 9.0 KB
📄 SKILL.md 6.4 KB

SKILL.md

---
name: install-rho
description: "Install and configure Rho from scratch (Doom-style init.toml + sync). Only prereq: a coding agent that can run shell commands."
---

# 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
# Find the [settings.heartbeat] section and set the interval
sed -i 's/interval = "30m"/interval = "'"${HEARTBEAT_INTERVAL}"'"/' ~/.rho/init.toml
rho sync
```

### 6. Verify installation

**Constraints:**
- You MUST run `rho doctor` and report any failures.
- You MUST NOT declare success if doctor reports errors.

```bash
rho doctor
```

### 7. Authenticate

**Constraints:**
- You MUST tell the user to run `rho login` to set up their LLM provider.
- You MUST NOT run `rho login` automatically (it's interactive).

Tell the user:

> Run `rho login` to authenticate with your LLM provider (Anthropic, OpenAI, etc). This is interactive — you'll need to provide API keys or log in via browser.

### 8. Start rho (optional)

**Constraints:**
- You MUST ask before starting background processes.

```bash
rho
```

This starts the daemon if needed and attaches to the tmux session.

### 9. Post-install orientation

Share these essentials with the user:

**Key files:**
- `~/.rho/init.toml` — Main config (Doom-style: modules, settings)
- `~/.rho/packages.toml` — Third-party pi packages
- `~/.rho/brain/brain.jsonl` — Single source of truth for all memory (behaviors, learnings, preferences, tasks, reminders)

**Memory system:**
- `/brain` or `brain action=list` — View memory stats
- `brain action=add type=learning text="..."` — Add a learning
- `brain action=add type=preference text="..." category=Code` — Add a preference
- `brain action=add type=task description="..." priority=high` — Add a task
- `brain action=add type=reminder text="..." cadence={kind:"daily",at:"08:00"}` — Add a reminder
- `memory-consolidate` — Run consolidation (decay stale entries, mine sessions since last consolidation)

**CLI basics:**
- `rho` — Start and attach
- `rho status` — Show daemon and module status
- `rho doctor` — Health check
- `rho trigger` — Force immediate heartbeat
- `rho stop` — Stop daemon
- `rho upgrade` — Update rho and sync new modules

**Inside a session:**
- `/rho status` — Heartbeat state
- `/rho now` — Trigger check-in
- `/rho interval 30m` — Set check-in interval

**tmux essentials (if unfamiliar):**
- Detach: `Ctrl-b d`
- List sessions: `tmux -L rho ls`
- Attach: `tmux -L rho attach -t rho`

## Troubleshooting

| Problem | Fix |
|---------|-----|
| `rho sync` says pi missing | `npm install -g @mariozechner/pi-coding-agent` |
| `rho doctor` shows settings out of sync | `rho sync` |
| `rho` not found after install | Add `~/.local/bin` to PATH |
| tmux missing | Install with your platform's package manager |
| Node.js < 18 | Upgrade via nvm or NodeSource |
| `install.sh` fails on NixOS | Dependencies must be in your nix config, not installed via apt |

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

install-rho

Directory Structure

SKILL.md

Report

Notice