dvoid docs
WorkbenchGuides

Getting started

Install dvoid, sign in to your org, set up your machine and start your first workstream.

dvoid-io/workbench · public

dvoid installs as one release binary on macOS, Linux (Debian, Ubuntu or Mint) and native Windows. It includes the console and needs no Bun or Node. The releases are on GitHub and need access to the dvoid-io repositories: accept the invitations your org sent you first.

1. Install Git and the GitHub CLI

# Homebrew first (https://brew.sh), following its printed shell setup
brew install gh

Open a new terminal, then sign git in to GitHub (every OS):

gh auth login
gh auth setup-git

Skipping gh auth setup-git makes every private clone fail later.

2. Install dvoid

The installer picks the release for your OS and CPU, downloads it through gh and prints dvoid version. It refuses to overwrite an existing install; use dvoid update for that.

dvoid_installer=$(mktemp)
gh api repos/dvoid-io/workbench/contents/install.sh -H 'Accept: application/vnd.github.raw+json' > "$dvoid_installer" && sh "$dvoid_installer"
rm -f "$dvoid_installer"
export PATH="$HOME/.local/bin:$PATH"

Windows on ARM64 has no native release. In WSL, use the Linux installer for the console.

3. Sign in to your org

Use the org slug you were given:

dvoid login --org your-org

A browser opens on your org's sign-in. dvoid whoami shows who you are signed in as.

4. Preview, then set up your machine

dvoid bootstrap --plan --class partner-dev --org your-org   # writes nothing
dvoid bootstrap --class partner-dev --org your-org

The plan shows each step, plus your org's repos, templates and plugin changes. Bootstrap installs the CLI's tools and the agent harnesses (Claude Code, Codex and pi), the console's needs, and a shell baseline; it keeps your own dotfiles. It is safe to rerun: fix a failed step and run it again. A summary that ends "with warnings" needs reading, warning by warning.

Already have a machine you only want the console and its Assistant on? Use --class partner-console instead.

5. Check it

Open a new terminal, then:

dvoid doctor
dvoid harness

dvoid doctor lists anything that drifted from your machine's spec with its fix, usually dvoid update. dvoid harness lists the agents you can launch.

Pi and the Assistant run on the model fleet with your own key, once your admin has set up your fleet access:

dvoid llm setup --lease
dvoid llm check

6. Start your first workstream

dvoid estate config show    # your org's repos and templates
dvoid workstream new        # a wizard: project, name, repos, goals
dvoid workstream pi         # or claude, codex, hermes

Or run dvoid to open the console, and press Tab for the Assistant.

Next

On this page