Documentation

Installing Veyandor

Veyandor is a desktop app plus a local background daemon (bundled inside the app — you don't install it separately). Windows is fully supported today; Linux works via the AppImage; macOS is early/experimental (see the macOS note below).

Before you install: Claude Code

Veyandor drives your own local installation of Anthropic's Claude Code, running under your own Claude subscription — Veyandor never uses an API key. Install Claude Code and log in first:

  1. Install Claude Code (see Anthropic's official instructions).
  2. Run claude once and complete /login.

Veyandor checks this for you on first launch and can re-test the connection at any time.

Download

Get the installer for your operating system from the latest release:

→ https://github.com/hockeyben/veyandor-releases/releases/latest

Heads-up: current builds are not yet code-signed, so your OS will show a warning the first time you run them (see below). Signing/notarization is in progress.

Windows

  1. Download the .msi (or the _x64-setup.exe).
  2. Run it. Windows SmartScreen may say "Windows protected your PC." Click More info → Run anyway (this appears because the installer isn't code-signed yet).
  3. Launch Veyandor from the Start menu. The first launch starts the bundled daemon automatically and opens the onboarding wizard.

Linux

Pick one:

  • .AppImage (recommended — this is the format that self-updates): chmod +x Veyandor_*.AppImage && ./Veyandor_*.AppImage
  • .deb (Debian/Ubuntu): sudo dpkg -i Veyandor_*_amd64.deb
  • .rpm (Fedora/RHEL): sudo rpm -i Veyandor-*.x86_64.rpm

.deb/.rpm installs work but do not self-update — use the AppImage if you want in-app updates. If a WebKitGTK runtime is missing, install your distro's webkit2gtk package.

macOS (early/experimental)

Download the .dmg and drag Veyandor to Applications. Because the app is not yet notarized, macOS Gatekeeper will block it ("unidentified developer" / "damaged"). To run it anyway:

  • Right-click the app → Open → confirm, or
  • xattr -dr com.apple.quarantine /Applications/Veyandor.app

macOS support is early: until the app is notarized (a paid Apple Developer step we haven't completed yet), in-app auto-update does not work on macOS and you may need the workaround above on each install. Windows and Linux (AppImage) are the smoother paths today.

First launch

On first launch Veyandor runs a short onboarding wizard (connect → check Claude Code → add your first project → optional license). See the Quickstart to run your first goal, or Troubleshooting if something looks off.