Download
Grab the latest release from GitHub:
FilDOS Releases
Download the latest .dmg (macOS) or .exe installer (Windows).
macOS: right-click → Open on first launch to bypass the Gatekeeper prompt
(the app is not yet notarized).
Build from source
Clone the repository
git clone https://github.com/ahmedfahim21/FilDOS.git
cd FilDOS
Install dependencies
Requires Node 22+ (the built-in node:sqlite module is used for the database). Run in development mode
This starts electron-vite with HMR for the renderer. Main and preload processes
rebuild on change. Build for production
npm run build
npm start # preview the production build
Verify your setup
Run the test suite to confirm everything is wired up correctly:
npm test # unit + integration (Vitest)
npm run typecheck # TypeScript (both main and renderer projects)
npm run lint # ESLint flat config
Next steps
File Management
Keyboard shortcuts, drag-and-drop, and the undo stack.
AI Search
Download a model and start indexing your files.
