knos

Knowledge OS — a lightweight Obsidian-style markdown notes app with an embedded pi-powered agent.

• Vision: docs/knos-vision.md
• Foundation scope: docs/idea.md
• Architectural decisions: docs/questions-idea.md
• Developer guide: CLAUDE.md

Quick start

npm install
npm run dev        # backend on :3002, Vite on :5174

Then open http://localhost:5174/.

Knos CLI

Once installed, the agent (or you) can use the knos CLI to interact with the vault:

knos ls /
knos cat work/notes.md
knos write work/notes.md "# Hello"
knos search "agent"
knos reindex

See CLAUDE.md for full layout and conventions.