CLI Overview

The wl command-line tool is the primary interface for developers and CI systems to interact with Workloom.

Installation

After building the monorepo:

pnpm --filter @workloom/cli exec wl --help

Or link globally:

cd apps/cli && pnpm link --global
wl --help

Configuration

The CLI reads configuration from ~/.config/workloom/config.toml:

registry_url = "http://localhost:3001"

This can be overridden per-command with --registry-url.

Authentication

The CLI uses device authorization flow (RFC 8628):

wl login

Tokens are stored in ~/.config/workloom/credentials.json with restricted file permissions.

Command groups

Group	Commands	Purpose
Auth	login, logout, whoami	Authentication
Workspace	init, bind, unbind, status	Workspace binding
Sync	pull, push	Package sync

See Commands for the full reference.