Install
Install Doxwell
Doxwell 1.0 ships as a Linux AppImage first. Signed macOS and Windows packages are in preparation and will land in the same 1.0 line.
Linux
1. Verify the download
Before anything else, verify the SHA-256 and minisign signature of the AppImage you downloaded. Instructions are on the verify page. /verify.
2. Make it executable
From a terminal in the folder where the AppImage was saved:
chmod +x doxwell-v1.0.0-linux.AppImage
./doxwell-v1.0.0-linux.AppImage3. Launch it
Double-click the AppImage, or run it from the terminal. Doxwell opens the system tray and starts the first-run wizard.
4. First-run wizard
The wizard asks for your LLM provider (API key or local Ollama), a storage directory for the Doxwell database, and the folders Doxwell should watch. You can change all of these later in settings.
Tray icon
Once Doxwell is running, a feather icon appears in your system tray. It shows the current queue count (e.g. "3 waiting") and opens the main window on click. Right-click for pause, settings, and quit.
First-run wizard (recorded walkthrough)
A recorded walkthrough of the first-run wizard will replace this placeholder.
What happens when you add a file?
Doxwell automatically watches the directories you configured and detects new files within about 10 seconds.
New files are queued for processing — auto-ingest runs without any popup. The tray icon reflects the current queue count.
Behaviour is configurable in settings. If you prefer full manual control, switch to manual-only mode and review each batch before it runs.
macOS
Coming soon. These instructions are placeholders — a signed and notarized .dmg is in preparation. Until then, Doxwell on macOS requires a manual build from source.
Windows
Coming soon. These instructions are placeholders — a signed .msi installer is in preparation. Until then, Doxwell on Windows requires WSL2 + the Linux AppImage.