# xos > xos is a methodology and CLI for developers who think and build in the same place. It co-locates **knowledge** (an Obsidian vault) and **code** (your git repos) in one directory tree, then indexes both into a single searchable knowledge graph that humans and AI agents navigate the same way. The CLI is a single Rust binary (xos). Linux requires glibc 2.39+ (Ubuntu 24.04+). **⚠️ Work in progress.** xos is an early, opinionated tool developed in the open — not a polished product. It began as one developer's personal workflow, and adopting it currently means adopting that workflow. Notably, keeping the search index current is **manual**: if you don't re-run `xos index` after changing notes, you get stale/degraded results. Don't use xos unless you're comfortable running and updating it yourself. This site is intentionally bot-friendly. This page and `llms-full.txt` are Markdown, meant to be read by LLMs and crawlers as well as people. ## Documentation Full documentation is not published on this site yet. It will live in the [icewaterlabs/xos](https://github.com/icewaterlabs/xos) GitHub repo once that repo is public. ## Optional - [Full documentation (single file)](https://www.iamxos.ai/llms-full.txt): All of the above concatenated for one-shot ingestion. - [Source on GitHub](https://github.com/icewaterlabs/xos): The `xos` CLI source, releases, and issues. - [Install script](https://github.com/icewaterlabs/xos/releases/latest/download/install.sh): The shell installer invoked by the one-line install command.