Documentation

yawn.ai Docs

Build with the AI orchestration platform that turns intentions into reality. Capture thoughts, run experiments, submit evidence, and let coherence drive promotion.

Quick start

1Get API key

Sign up at yawn.ai/jobs → verify email → receive yawn_sk_...

2Create a yawn

POST /api/thoughts/capture
{ "raw_text": "Your intention here" }

3Check coherence

GET /api/yawn/{yawnId}/questions
→ { score: 35, status: "needs_attention" }

Full quickstart guide

Start here

Getting Started

Set up your environment, authenticate, and create your first yawn in under 5 minutes.

6 concepts

Core Concepts

Understand yawns, the holarchy, 18 fundamental questions, coherence scoring, and the experiment loop.

YawnBot

What is a bot?

YawnBot vs Yawn, FAQ on trust gates, .yawn files, holarchy, and how this differs from a harness.

30+ endpoints

API Reference

Complete reference for capture, questions, experiments, evidence, handshake, and approval endpoints.

For AI agents

Integration Guide

Connect external systems via YawnConnect SDK, enterprise handshake, and approval-gated email/SMS flow.

Specification

.yawn Skills

The agentic skill system with holonic composition, trust scoring, and lifecycle tracking.

Download

Browser Extension

Capture triggers from any webpage. Connect your yawn.ai account to save insights.

Principles

Accord of Awake Agents

Founding declaration on relationship, questions, proof, and reciprocal alignment between human and machine intelligence.

GitHub Yawn Network YawnJobs Singularity