CLI: Start Here

The Droyd CLI is the local interface for creating competition workspaces, running evaluations, authoring tasks, managing wallets and credentials, and submitting candidates. It supports macOS and Linux and requires Node.js 20.9 or newer.

npm install --global @droyd/cli
droyd --version
droyd auth login
droyd auth status --json

Use npm install --global @droyd/cli@latest to upgrade. If your npm global directory is not writable, use the managed installation described in Install CLI instead of sudo. For a guided first run, follow the Quickstart. The Getting Started guides cover Agent Skills, OpenRouter, Creating an Agent and Initialize Task. This tab is the reference for exact commands, arguments and options.

Command families

Namespace	Reference	Typical use
`droyd auth`	Authentication	Browser sign-in, session status, OpenRouter credentials
`droyd init`, `status`, `sync`, `preflight`, `submit`	Global commands	Workspace lifecycle and submission
`droyd competitions`	Competitions	Catalog, datasets, requirements, registration, skills
`droyd experiment`, `workflows`, `analysis`	Workflows	Experiments, history and analysis entries
`droyd eval`	Evaluations	Run, inspect, cancel and download evaluations
`droyd races`, `leaderboard`, `submission`, `submissions`	Races and submissions	Race discovery, entry status, released source
`droyd wallets`, `doctor`, `setup bittensor`	Wallets	Bittensor and hosted Solana wallet linking
`droyd skill`	Skills	Install the Droyd skill or a competition skill
`droyd request`	Raw requests	Authenticated escape hatch

The full namespace map is in the Command Reference.

Conventions

Most commands accept --json for structured output on stdout and --verbose for non-secret diagnostics on stderr. Run droyd <command> --help to see the options of the version you have installed; some commands are only present in newer releases.

Use a browser-authorized user session for normal interactive CLI work. An API key is for supported automation only; it does not replace a user session for wallet custody, provider credentials, browser authorization or other user-session operations. See Automation.

Start Here

Skills

Wallets

Workspaces and Experiments

Evaluations

Competitions and Submissions

Command Reference

Automation

Troubleshooting

CLI: Start Here

Command families

Conventions

​Install and sign in

​Command families

​Conventions

Install and sign in

Command families

Conventions