UluOps Documentation
TypeScript SDKs, MCP clients, and CLI tools for UluOps — the operations layer for agentic work. Runs become findings, findings become issues, and every decision about them is on the record with its reason. Git remembers what changed. UluOps remembers what was decided.
UluOps is in active development — APIs are stabilizing but may still change between minor versions for pre-1.0 packages.
First validation run
Get from zero to working results in 5 minutes.
Get started →Using Claude Code?
Connect via MCP — 99 tools, zero config beyond an API key.
MCP docs →Integrate via SDK
TypeScript SDKs for registry and validation tracking.
SDK docs →REST API reference
Direct HTTP access to Platform and Registry APIs.
API docs →Applications
The web apps this documentation supports — everything the SDKs and MCP clients can do is also visible here.
Registry
Browse and publish definitions, inspect effectiveness analytics and safety verdicts, manage your org.
registry.uluops.ai ↗ →Dashboard
Validation runs, issue lifecycle, cross-project analytics, and data export for your tracked projects.
app.uluops.ai ↗ →SDK Packages
Four SDKs and the CLI, covering the full UluOps surface area.
@uluops/core
The execution engine — run agents, commands, workflows, and pipelines against your code.
0.43.5 →@uluops/registry-sdk
Manage definitions — agents, commands, workflows, pipelines.
0.52.0 →@uluops/ops-sdk
Save runs, manage issues, read the log, analyze trends. 86 methods.
6.5.1 →@uluops/cli
The `ulu` command: run definitions, save runs, decide on findings, and read the project's second history with `ulu log`.
0.31.0 →@uluops/sdk-core
HTTP client, auth, and error infrastructure. For SDK authors.
0.17.0 →MCP Clients
For AI agents and Claude Code — thin protocol clients backed by the same APIs as the SDKs.
uluops-ops-mcp
55 tools for the tracker. Save runs, query issues, read the project log, analytics, analysis records. Zero business logic — thin client over ops-sdk.
55 tools · 2 resources →uluops-registry-mcp
MCP client for the Registry API. Browse, fetch, publish definitions, and track effectiveness from Claude Code.
44 tools →Platform Architecture
Two parallel access lanes to the same backend APIs:
Key Concepts
| Concept | Description |
|---|---|
| Definitions | Versioned YAML specs for agents, commands, workflows, and pipelines (ADL/CDL/WDL/PDL) |
| Failure Taxonomy | Four-domain classification: Structural, Semantic, Pragmatic, Epistemic |
| Fingerprinting | SHA-256 hash correlation tracking issues across runs as new, recurring, or regression |
| Recursive Appreciation | How improvements to agents cascade through the ecosystem |
New to UluOps? Start with the Quickstart — it walks through your first validation run end-to-end.