Linux
Download the latest Weave release and run it. The Linux build includes the full sandboxing stack (Bubblewrap + OverlayFS).
# Make the AppImage executable and run it
chmod +x Weave-x86_64.AppImage
./Weave-x86_64.AppImage
For the sandbox to work, your system needs
bubblewrap installed and a kernel that allows unprivileged user namespaces (the
default on most modern distributions). If it isn't already present, install it with your
package manager — e.g. apt install bubblewrap or
dnf install bubblewrap.
Linux-only features: Bubblewrap tool sandboxing and OverlayFS write review require Linux and are not present in Weave Lite for macOS.
macOS (Weave Lite)
Download Weave Lite, drag it to Applications, and launch. Weave Lite shares the chat and Weaves workflow but does not include the Linux sandboxing features — tools run directly on the host, confined to the project directory by path checks rather than a kernel sandbox.
Where Weave keeps its data
Everything is stored locally. Settings, projects, chats, and weaves live in a single SQLite database, and skills are plain Markdown files:
- Linux:
~/.config/weave/(data.dbandskills/) - macOS:
~/Library/Application Support/weave/
First launch
On first run, add a provider and agent so Weave can reach a model, then create a project. The Quickstart walks through this end to end.