Skip to content
lacause edited this page Mar 29, 2026 · 10 revisions

OCC — Claude Chain Orchestrator Wiki

Welcome to the OCC documentation. OCC is a workflow orchestration engine for Claude AI agents — define multi-step chains in YAML, execute them with parallel processing, and access everything via MCP or REST API.

Quick Navigation

Getting Started

  • Getting Started — Install, configure, run your first chain in 5 minutes
  • Configuration — Environment variables, .mcp.json, deployment options

Chain Authoring

  • Chain Format — Complete YAML reference for chain definitions
  • Step Types — All 11 step types explained with examples
  • Pre-Tools — Inject data before steps (web search, API calls, files, bash)
  • Pipelines — Chain multiple chains together

Tools

  • CLI — Command-line interface: run, validate, dry-run, cost estimate
  • REST API — All HTTP endpoints with request/response examples
  • MCP Tools — All 25 MCP tools for Claude Code / Claude Desktop

Advanced

  • Architecture — How OCC works internally (execution engine, dependency graph, process management)
  • Token Optimization — Minimize cost with caching, transforms, context strategies
  • Cookbook — Practical recipes and patterns

Help

  • FAQ — Common questions and troubleshooting

Key Concepts

Concept Description
Chain A YAML file defining a multi-step workflow. Each step is an LLM call, data transform, or control flow.
Step One unit of work in a chain. Can be an agent (LLM), router, evaluator, gate, transform, loop, merge, browser, subchain, debate, or webhook.
Pipeline Multiple chains executed in sequence, with outputs passed between them.
Pre-tool Data injection that runs before a step — web search, HTTP fetch, file read, bash command, or env var.
Variable Outputs from steps are stored as variables (output_var) and interpolated into later prompts via {variable_name}.
Wave A group of steps with no dependencies between them — they execute in parallel.
Gate A step that pauses execution until a human approves or rejects via the API.
Execution A running instance of a chain, with its own ID, status, step results, and SSE stream.

Clone this wiki locally