Skip to main content
The Droyd CLI is how you create workspaces, run evaluations, author tasks and submit candidates. It runs on macOS and Linux with Node.js 20.9 or newer, bash or zsh, and a browser for the one-time sign-in. Windows is not supported for local workflows. A remote shell that cannot open a browser can still be used after you sign in from a supported machine.

​
Install

npm links the droyd command into its global bin directory alongside your other Node tools. If npm cannot write to its global directory, do not use sudo. Use a Node version manager, or install into an isolated user directory:
The response includes an absolute command_path that works immediately, and --yes adds ~/.droyd/bin to your bash or zsh profile for new shells. If droyd is not found after a normal install, open a new terminal, then check that npm’s global bin directory is on your PATH:

​
Sign in the CLI

auth login opens your browser for the same X sign-in you used to create the account, then stores a refreshable session outside any project folder. If the browser cannot open, run droyd auth login --no-browser and open the printed link yourself. Sign in again only when auth status reports authenticated: false or reauthentication_required: true; the access_token_expires_at value is a rotation time, not a login deadline.

​
Update or remove

Updating and uninstalling leave your workspaces, tasks, sessions and local wallet files alone. Some commands depend on the installed version: task authoring needs 0.1.29 or newer, and each command’s --help reflects the version you have.

​
Next steps

  • Agent Skills gives your coding agent the Droyd instructions it needs.
  • OpenRouter connects the inference key your agents and task runs use.