Settings — What Every Page Controls
Three doors to the same window: the gear at the bottom of the Activity Bar, Ctrl+,, or search
settingsin 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 starsstat 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 |