File Management — Opening, Saving, and the Psi Library

Rho sees files a little differently: your .md files stay wherever they already live. There's no container you have to move your notes into — Psi is a lens laid over your files in place, not a place that owns them. This page covers opening, saving, making Rho your default .md app, and what the Psi library actually is.


Six ways to open a file

Way How
Shortcut Ctrl+O opens the native dialog (filtered to .md / .mdx / .markdown)
Quick Open Ctrl+P fuzzy-searches file names — open tabs + recent files + your entire Psi library — Enter to open
Explorer tool bar The 📂 Open File button at the top of the Side Bar (next to ✚ New Markdown)
Drag & drop Drop a .md anywhere on the window
Double-click Once Rho is your default handler, double-clicking a .md in your file manager opens it here (see below)
Links in documents Links to local .md files open inside the app (relative paths and #heading jumps both work)

Small kindnesses: the same file never opens twice — opening it again just focuses the existing tab. Launching Rho a second time (say, by double-clicking another file) won't spawn a new window either; the file is handed to the one already running.

Recent files keeps the last 10, waiting in the Recent grid on the new tab page (Ctrl+T).


Saving

  • Ctrl+S saves. Unsaved changes put a dirty dot on the tab, and closing the tab or the app asks first — nothing is silently lost.
  • If a file changes on disk (another editor, a git checkout), Rho refreshes the view automatically. While you're editing, that watcher pauses — external changes can't clobber the edits in your hands.

Where do new documents go? — the Psi folder

A blank document created in Rho (Ctrl+N) doesn't prompt Save-As on its first Ctrl+S. Instead:

  1. The filename comes from the document's first line (a timestamp is appended on collisions);
  2. It lands in your Psi folder — a notes folder you choose — and is indexed into the Psi library automatically.

The first time, a folder picker asks you to choose one (changeable any time in Settings › General › Psi folder). From then on, "new → write → Ctrl+S" is the whole note-taking loop — no filename to invent, no path to pick.


Making Rho the default .md app

On first launch Rho asks whether to become your default Markdown viewer. Missed it? No problem:

  • Click the ρ icon in the top-left to open the About dialog — the set as default button is there.
  • On Windows this writes the registry association; on Linux it goes through xdg-mime. After that, every double-clicked .md opens in Rho.

The Psi library: a lens, not a warehouse

Obsidian asks you to move files into its vault; Psi goes to visit your files where they already live.

A traditional vault Rho's Psi
Where files live Inside its directory — you move them in In place — project folders, Downloads, Documents, anywhere
Multiple locations One vault, one world Any number of folders join one galaxy
Does it touch files? Metadata often written into files Never moves, never rewrites your files; tags and categories live in the index

Rho gives this system an astronomical vocabulary: your library is a galaxy, each folder is a constellation, each document is a star. The status line at the bottom of the Psi panel reads exactly that: N stars · M constellations.

Three steps to start

  1. Click the ✦ Psi icon in the Activity Bar;
  2. Click Chart Folder… in its tool bar — the Markdown in the folder you pick is discovered and indexed;
  3. Done. The tree mirrors your real directories, the search box does full-text search, and the right bar (Ctrl+Shift+B) shows each document's tags, category, and link relationships.

From there:

  • Rescan Galaxy — re-sweep after big changes on disk (day-to-day edits are tracked automatically);
  • Open Galaxy — the 3D star map: each folder takes the shape of a real constellation, its documents are the stars, and the most-linked documents shine brightest.
  • Link documents with [[double brackets]] (autocomplete included while editing); clicking a [[name that doesn't exist yet]] creates the page on the spot.

Psi is an optional layer — without it, Rho is still a complete reader and notebook. But since new documents land in the Psi folder by default, the library tends to simply happen as you write.


The Files tree (optional)

Want a classic browse-by-folder panel? Turn on Settings › General › Show file tree and a Files tree appears in the Explorer view — pick a workspace folder to browse (remembered across launches). Two companion toggles: list the text/code files Rho can open (.txt, .py, .json… rendered as highlighted code blocks), or list every file.


Quick reference

To do How
Open a file Ctrl+O / Ctrl+P / drop it on the window / double-click a .md
New document Ctrl+N (first save lands in your Psi folder)
Save Ctrl+S
Recent files Ctrl+T → Recent
Bring a folder into the library Psi panel → Chart Folder…
Re-sweep the library Psi panel → Rescan Galaxy
3D star map Psi panel → Open Galaxy
Change the Psi folder Settings › General › Psi folder
Set as default .md app ρ icon → About → set as default
Copy path / show in file manager Right-click the tab
Open in Rho MD →