Philosophy
Structure should emerge, not be imposed
Five ideas decide what Orbgem does and, more often, what it leaves out.
Structure emerges. It is not chosen up front.
A folder tree asks you to classify a thought before you have finished having it. During an incident that question, where does this go, is pure cost, and the honest answer is usually that you do not know yet.
Orbgem has no folders. You write the line, and it lands in today's note. Organisation arrives afterwards, from the
[[links]]you make, the aliases a note answers to and the properties at its top. The shape of your vault is a record of how things turned out to be related, not a guess made in advance.Everything is a note.
Daily logs, templates, canvas boards and the manual itself are all Markdown notes. There is no second kind of object with its own rules, its own editor and its own way of getting lost.
That keeps the product small enough to hold in your head. Anything you learn about one note, how to link it, search it, export it, is true of all of them.
Summarise in layers, when you come back.
Raw logs are cheap to write and expensive to reread. The fix is not to write less. It is to mark what mattered on a later pass: bold the turning points, highlight the single conclusion, leave the open tasks open.
Scan Mode, on Option+SorAlt+S, is the payoff. It hides everything except bold text, highlights and unfinished tasks, so a month of history reads as the handful of lines you already decided were important.
Memory is spatial.
People remember where things are more easily than what they were called. A list of search results has no where. A graph does: the database note sits next to the service that depends on it, and the runbook sits next to both.
So Orbgem gives the same notes three shapes. The timeline answers when. The graph answers what is connected to this. The canvas lets you lay an incident out by hand and think with your eyes.
Your notes should outlive the app.
A notebook is only worth trusting if you can walk away from it. Orbgem stores each note as the exact Markdown text you wrote, not a proprietary document it would have to convert back.
One click exports the whole vault as a .zip of .md files that open unchanged in Obsidian or any text editor. If Orbgem stops being the right tool, you leave with everything, in a format that will still be readable long after this one is forgotten.