CLI Reference

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

v0.31.0ulu

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

@uluops/cli GitHub

# 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

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

logulu log

The project's second history: runs (what was examined) and decisions (what was decided, with reasons) interleaved, newest first. Git remembers what changed; this is the record of what was decided about what the agents found.

1 command

orgsulu orgs

Read an org's member-visible activity.

1 command

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