# FilDOS

## Docs

- [Introduction](https://docs.fildos.cloud/introduction.md): FilDOS is an open-source, AI-native file browser that runs entirely on your machine.
- [Quickstart](https://docs.fildos.cloud/quickstart.md): Build FilDOS from source and run it in a couple of minutes.
- [File Management](https://docs.fildos.cloud/features/file-management.md): A real file manager first — copy, move, rename, trash, and undo, all from the keyboard.
- [Tags & Recents](https://docs.fildos.cloud/features/tags.md): Colour-coded tags and a persistent recents list, stored in SQLite — they follow files through renames and moves.
- [Search by Meaning](https://docs.fildos.cloud/features/ai-search.md): On-device semantic search — find files by what's inside them, not just their names.
- [Ask AI](https://docs.fildos.cloud/features/ask-ai.md): Chat with your files through a fully on-device LLM that can mention files, run searches, and act on your data.
- [Canvas](https://docs.fildos.cloud/features/canvas.md): A GPU-rendered knowledge graph of your files, built from embedding similarity, extracted entities, and temporal sessions.
- [Cloud Drives](https://docs.fildos.cloud/features/cloud-drives.md): Browse Google Drive and Dropbox alongside local folders, through the same interface.
- [Architecture](https://docs.fildos.cloud/engineering/architecture.md): Electron + React + TypeScript with a strict process boundary and a typed IPC spine.
- [The IPC Contract](https://docs.fildos.cloud/engineering/ipc-contract.md): A Result-typed spine — every filesystem operation returns a discriminated union, so expected failures become friendly messages, not crashes.
- [AI Pipeline](https://docs.fildos.cloud/engineering/ai-pipeline.md): How FilDOS extracts, embeds, indexes, searches, and reasons over your files — entirely on-device.
- [Data Layer](https://docs.fildos.cloud/engineering/data-layer.md): Everything that isn't the filesystem lives in SQLite via Node's built-in node:sqlite, with Drizzle ORM on top — and zero native dependencies.
- [Testing & CI](https://docs.fildos.cloud/engineering/testing.md): Vitest for unit and integration tests, Playwright for end-to-end, running on Ubuntu, macOS, and Windows.
- [Changelog](https://docs.fildos.cloud/changelog.md): What's new in FilDOS.