Getting Started

Install Vect

Download the build for your machine from the latest release:

Platform	File
macOS (Apple silicon)	`Vect_<version>_aarch64.dmg`
Windows	`Vect_<version>_x64-setup.exe`
Linux	`Vect_<version>_amd64.AppImage`

The macOS build is signed and notarized, so it opens without a Gatekeeper detour. Vect updates itself from the same releases once installed.

What you need alongside it

Vect runs agent CLIs; it does not replace them or ship its own model. Install at least one and sign it in first:

claude (Claude Code)
codex (Codex CLI)
opencode
hermes

Whichever ones are on your PATH are detected on launch. An agent you have not installed simply does not appear in the picker.

Your first session

Open Vect.
Press Cmd+N (macOS) or Ctrl+N to start a session.
Pick an agent from the dropdown.
Type your prompt and press Enter.

The session view streams the agent's output as it arrives. Sessions are read from and written to each agent CLI's own history on this machine, and Vect's own state lives in ~/.vect/. Nothing is uploaded.

Project instructions

Vect reads the project's instructions file from its root, CLAUDE.md unless your agent expects a different name. Edit it with Cmd+Shift+P then search for "Edit CLAUDE.md" to configure project-level instructions.

Building from source

Vect's source is not public, so there is no clone-and-build path for now. The releases above are the supported way to run it.