Settings — What Every Page Controls

Three doors to the same window: the gear at the bottom of the Activity Bar, Ctrl+,, or search settings in the Command Palette. The navigation on the left has two groups: Options (app-level settings) and Plugins (one page per plugin). Every change applies instantly and is remembered — there's no "save settings" button here.


General: toggles and the Psi folder

Seven switches, each minding one small thing:

Toggle What it does Default
Show word count Word count in the Status Bar (CJK characters each count as one word) On
Show token count Token estimate in the Status Bar Off
Show reading time Estimated reading time in the Status Bar Off
Show file tree The Files tree in the Explorer side bar Off
Show all openable documents The tree also lists .txt / source-code files Rho can open (rendered as highlighted code blocks) Off
Show non-Markdown files The tree lists every file Off
Show Discover on new tabs Fetch the latest published docs from rho.md for the new tab page. Turned off, the app makes no network requests of its own On

At the bottom sits the Psi folder — where new documents land on first save, and the root of your Psi notes library (see File Management).


Appearance / Keyboard / Editor / About

  • Appearance: the Light / Dark segmented control (Ctrl+Shift+T does the same). Per-document typography themes are covered in Themes.
  • Keyboard: a live table of every shortcut — one command per row with its keys, read straight from the registry, so it can never drift from actual behavior. Custom keybindings are on the way.
  • Editor / About: placeholder pages for now ("Coming soon"). Version info currently lives in the About dialog behind the top-left ρ icon.

Cloud: account, publishing, and sync

The Rho desktop app can connect to the rho.md cloud service (optional — signed out, nothing local is missing):

Signing in: enter your email → receive a 6-digit code → done. No password. The session credential goes into the OS keychain (GNOME Keyring / Windows Credential Manager) — never a plain-text file.

Creating your galaxy: on first sign-in you claim an @handle — your galaxy (home page) address on rho.md. After that, this page becomes your identity card:

  • @handle (one-click copy of your page link), with display name and bio edited in place
  • An On N star charts · charting M galaxies · K stars stat line (how many star charts hold your galaxy + what your own chart holds)
  • Open my galaxy opens your galaxy page inside the app

My documents: the documents you've uploaded — each row shows a status badge (published / unlisted / private), a copy-link button, and inline publish / unpublish. Uploading and publishing are also available from the Command Palette (search cloud).

The rest: a storage meter (shows the percentage left); above the free tier there's an Upgrade to Pro entry (the subscription completes in your system browser; once subscribed it becomes Manage subscription); a Psi sync row shows the last sync time with a Sync now button — what syncs is your Psi index (tags / categories / link relationships), so your galaxy carries across devices; and Sign out at the bottom.


Plugins: one page per plugin

Each plugin in the Plugins group gets its own page, headed by the same Enabled switch — turning it off instantly removes everything the plugin contributes (icons, panels, commands); turning it back on restores it all, no restart needed. The Psi document manager is a built-in capability and has no switch.

Calendar

A month view in the Explorer side bar. Click a date to open (or create) that day's daily note — a lightweight daily-notes flow.

Pomodoro

A focus timer with its own Activity Bar view: a ring of progress plus start / pause / skip / reset. Its settings cover focus length, short/long break lengths, and rounds. Phase changes fire a system notification, and the timer keeps running in the background — switching views doesn't interrupt it.

RHO AI

The built-in AI assistant: chat over your document library, search it, analyze it, and have it author interactive documents for you. Its settings page:

Field Notes
Provider Claude by default (bring your own API key); also OpenAI, local Ollama (free, offline), or any OpenAI-compatible endpoint (LM Studio, vLLM, self-hosted gateways…)
API Key Stored in the OS keychain, never in plain text. Shows "✓ Key set" once saved; local Ollama needs no key
Model Leave blank for the provider's default
Persona (system prompt) The assistant's system prompt — tune it however you like
Max tokens The output cap per reply (authoring long documents needs headroom)

Until a key is configured, the chat panel shows a setup notice — RHO AI is bring-your-own-key by design; the app never routes you to a paid service by default.


Quick reference

To change Go to
Status Bar stats / file tree / new-tab Discover General
Where new documents save General › Psi folder
Light / dark theme Appearance (or Ctrl+Shift+T)
See every shortcut Keyboard
Cloud account / publishing / sync Cloud
Enable / disable a plugin Plugins group → that plugin's page → Enabled
AI provider / key / persona Plugins › RHO AI
Open in Rho MD →