The registry
Registers everything digital
One pointer registry — kb · code · media · bin — wherever your stuff already lives. No scaffold to adopt first.
kb
knowledge base
Notes, decisions, docs, people. Any existing vault, registered where it already sits.
code
code
Every repo, independent git history. Cloned org repos land untouched by xos itself.
media
media
Photos, video, captures — wherever they already live on disk.
bin
bin
Binaries and tools, registered and addressable, not hunted for in PATH.
~/.xos/config.json
~/.xos/ # user-level, not per-project
├── config.json # the pointer registry
├── kb/ → ~/Documents (or any existing vault)
├── code/ → ~/code (or any existing checkout)
├── media/ → wherever it already lives
└── bin/ → ~/.local/bin (registered tools)
The ontology
ox — the default ontology xos ships
Every dimension xos tracks reduces to six questions. ox is the open 5W+H structure underneath: the shape state takes before anything gets built on top of it.
whopeoplewhatresourceswhentimewhereplacewhygoalshowplans
ox is the default ontology xos ships; xos is the OS ox runs on.
Get started
Ready to register everything?
Public repo access is opening soon. Install instructions and docs will link here from GitHub once it does.
Docs — coming soon