CLI Reference

Unified CLI for UluOps — validation tracking and registry management from a single command.

v0.21.1ulu

Download SKILL.mdHand this file to any LLM for instant CLI fluency — every command, flag, and workflow in one reference.

Installation

npm install -g @uluops/cli

Quick Start

bash

# Install
npm install -g @uluops/cli

# Authenticate
export ULUOPS_API_KEY=ulr_your-api-key-here

# Create a project and run a validator
ulu projects create my-project
ulu exec agent code-validator ./src --project my-project

# View results
ulu runs latest my-project
ulu issues list my-project --status open

Command Groups

authulu auth

Authentication and credential management. Login, register, manage sessions and API keys.

14 commands

configulu config

CLI configuration and profile management. Manage multiple environments with named profiles.

7 commands

projectsulu projects | ulu p

Project lifecycle management. Create, list, archive, and manage validation projects.

10 commands

runsulu runs | ulu r

Validation run management. Save, compare, and archive pipeline results.

10 commands

issuesulu issues | ulu i

Issue tracking and management. Query, update, close, and annotate validation issues.

14 commands

analyticsulu analytics | ulu a

Validation analytics and metrics. Explore agent performance, issue trends, and coverage gaps.

11 commands

taxonomyulu taxonomy

Inspect the failure taxonomy schema. View domains, severity codes, and statuses.

1 command

definitionsulu definitions | ulu def

Workflow definition management (registry API). Create, publish, and manage agent, command, workflow, and pipeline definitions.

9 commands

versionsulu versions

Definition version history and comparison.

2 commands

depsulu deps

Dependency graph inspection. View what a definition depends on and what depends on it.

2 commands

forksulu forks

Definition forking and lineage. Fork published definitions and trace ancestry.

4 commands

modelsulu models

AI model catalog. Browse available models, resolve aliases, and check capabilities.

5 commands

languagesulu languages | ulu lang

Definition language schemas. Browse ADL, CDL, WDL, and PDL with current version info and full JSON Schema content.

1 command

execulu exec | ulu x

Execute agents, commands, workflows, and pipelines. Run validation directly from the terminal.

7 commands

executionsulu executions

Track definition execution metrics. Record executions and query statistics.

2 commands

translationulu translation

Definition translation and upgrade tools. Re-translate with the latest engine or upgrade legacy YAML.

3 commands

completionulu completion

Generate shell completion scripts for tab completion.

3 commands

Global Options

Every command accepts these flags:

Flag	Description	Default
`--api-key <key>`	API key (overrides environment variable)	—
`--profile <name>`	Config profile to use	default
`--timeout <ms>`	Request timeout in milliseconds	30000
`--json`	Output in JSON format for scripting	—
`--debug`	Enable debug output	—
`-q, --quiet`	Suppress spinners and non-essential output	—
`-V, --version`	Output the version number	—
`-h, --help`	Display help for command	—

Environment Variables

Variable	Description	Default
`ULUOPS_API_KEY`	API key for authentication	—
`ULUOPS_EMAIL`	Email for session auth	—
`ULUOPS_PASSWORD`	Password for session auth	—
`ULUOPS_DEBUG`	Enable debug logging	false