Skip to content

Install

Weaver ships as a single self-contained binary. No Node, npm, or other runtime is needed to run it.

Terminal window
curl -fsSL https://raw.githubusercontent.com/sean35mm/weaver/main/install.sh | sh

This downloads the right binary for your OS/arch (macOS and Linux, arm64 and x64) into ~/.local/bin/weaver. If that directory isn’t on your PATH, the installer tells you the line to add.

  • macOS — arm64 (Apple Silicon) and x64
  • Linux — arm64 and x64 (glibc)
  • Windows — via WSL2: install inside your WSL distro and the linux binary works as-is. Native Windows isn’t supported today; it may come later if there’s demand.

Verify it:

Terminal window
weaver --version
weaver --help

Weaver updates itself — no reinstall:

Terminal window
weaver upgrade # download + replace with the latest release
weaver upgrade --check # just check whether a newer version exists
Terminal window
weaver uninstall # removes the binary and ~/.weaver (prompts first)
weaver uninstall --keep-data # remove the binary but keep your stores
weaver uninstall --yes # skip the confirmation prompt

Any weaver blocks left in project or global instruction files are self-disabling; run weaver deinit or weaver deinit --global first if you want them removed.

If you’re hacking on Weaver itself, you can run it without installing — see Contributing:

Terminal window
node src/cli.ts --help # or: bun src/cli.ts --help