The open standard for how anything works

Define. Record.
Optimize.

Every process — APIs, teams, companies, human-AI collaboration — can be defined, recorded, and improved. Two YAML files. One standard.

SOP DocThe Loop

Open source · Apache 2.0 · 9 CLI commands · 113 workflow examples

Pillar 1

SOP Doc

See how things work. Define processes as .osop files. Browse them visually. Understand any API, team, or company at a glance.

API Doc shows each endpoint. SOP Doc shows the sequence — which steps, in what order, who is involved, what data flows between them. Non-engineers can read it too.

Browse SOPs →
Pillar 2

The Loop

Make things better. Execute workflows, record what happened, let AI write a better version. Each cycle gets faster, cheaper, more reliable.

.osoplog records every step: duration, cost, tools, AI reasoning, human decisions. Feed logs to osop synthesize. AI reads the patterns. You get an optimized .osop. Repeat.

See The Loop →

See it in action

OSOP uses its own format to explain itself. Click Visual to see the flow. Click .osop to see the YAML.

Stripe Payment Flow (API SOP)

stripe-payment-flow.osop.yaml
POST /v1/customersapi

Create a Stripe customer with email and metadata.

↓sequential→ POST /v1/payment_intents
POST /v1/payment_intentsapi

Create a payment intent. Amount, currency, customer ID.

↓sequential→ POST /v1/payment_intents/{id}/confirm
POST /v1/payment_intents/{id}/confirmapi

Confirm the payment with a payment method.

↓sequential→ GET /v1/payment_intents/{id}
↓fallback→ POST /v1/payment_intents
GET /v1/payment_intents/{id}api

Verify the payment succeeded.

↓conditional→ AI Generate Receipt
AI Generate Receiptagent

AI generates a personalized receipt email.

Open in Editor

The Optimization Loop

the-loop.osop.yaml
osop runcli

Execute the workflow. Agent nodes call LLMs. API nodes send HTTP requests.

↓sequential→ .osoplog Generated
.osoplog Generatedsystem

Every node: timestamps, duration, cost, tools, AI reasoning, human decisions.

↓sequential→ osop synthesize
osop synthesizeagent

Feed multiple .osoplog to AI. It writes an optimized .osop.

↓sequential→ osop diff
osop diffcli

Compare old vs new. Per-step duration, cost, status changes.

↓sequential→ Human Reviews
Human Reviewshuman

Accept, modify, or reject. The human decides.

↓loop→ osop run
Open in Editor
Browse all SOPs →See The Loop →

Everything serves the two pillars

CLI, editor, SDKs, converters, MCP server, agent integrations. All open source.

SOP Doc

Visual Editor
Interactive node graph. Drag and drop .osop files.
113 Examples
API SOPs, DevOps, AI agents, business processes.
Format Converters
Import from GitHub Actions, Airflow, n8n.
VS Code Extension
Syntax highlighting, validation, preview.

The Loop

OSOP CLI (9 commands)
run, diff, synthesize, validate, render, test, report.
MCP Server (5 tools)
Any AI agent can execute and optimize workflows.
Agent Rules (18 platforms)
Drop-in .osoplog generation. Start The Loop.
OpenClaw Skill (5 skills)
Session logging, reports, review, optimization.
View all on GitHub →

“It started with wanting to know what the AI did. Then I realized every team has the same problem — processes are invisible. Every API sequence, every company workflow, every human-AI collaboration. If you can't see it, you can't improve it. OSOP makes it visible.”

— Why OSOP exists

Two YAML files. That's it.

.osop defines what should happen. .osoplog records what did happen. Everything else builds on top.

pip install osop
SOP DocThe Loop