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 ghOpen a new terminal, then sign git in to GitHub (every OS):
gh auth login
gh auth setup-gitSkipping 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-orgA 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-orgThe 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 harnessdvoid 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 check6. 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, hermesOr run dvoid to open the console, and press Tab for the Assistant.
Next
Customizing: templates, playbooks, layouts, workspaces
Make dvoid start, arrange and run your work the way you want, for you alone or for your whole org.
Machine checks and recovery
Diagnose and repair your machine, your dvoid installation and your fleet access, and see where a machine's configuration comes from.