# Zap

## Docs

- [Agent Connections: Codex, Claude Code, Cursor, OpenClaw, Hermes](https://docs.zap.wzrd.tech/agent/connections.md): Connect any coding agent — Codex, Claude Code, Cursor, OpenClaw, Hermes — to Zap's remote skill registry and CLI so it can author, validate, and run recipes autonomously.
- [Eve Runtime: Agent Configuration, Commands, and Build](https://docs.zap.wzrd.tech/agent/eve.md): Zap is built on the Eve agent framework. Learn the Eve project layout, how to read agent configuration, useful eve commands, and how channels work.
- [Zap Agent Framework: Eve-Powered Generative Recipes](https://docs.zap.wzrd.tech/agent/overview.md): Zap is an Eve app convention. Recipes are portable skill directories that coding agents read, edit, validate, and run like any CLI command.
- [Skill Directories: Portable Zap Recipe Capabilities](https://docs.zap.wzrd.tech/agent/skills.md): Each Zap recipe lives in a skill directory with SKILL.md, Zap.md, and prompt files. Learn conventions, the skills manifest, and how to add registry skills.
- [Budget Caps and Live Cost Estimation for Zap Recipes](https://docs.zap.wzrd.tech/concepts/budget.md): Every Zap recipe declares an estimate_usd and a hard cap_usd. Learn how the CLI and web runtime enforce spend limits before any provider call.
- [AI Provider Routing and BYOK Keys for Zap Pipelines](https://docs.zap.wzrd.tech/concepts/providers.md): Zap routes each pipeline step to the mock, GMI, fal, or BYOK adapter. Learn provider priority, required keys, and the seven supported secret types.
- [Pipeline Steps: Building Generative Video Workflows](https://docs.zap.wzrd.tech/concepts/steps.md): Zap pipelines are sequences of typed steps. Learn all 11 step kinds, how to wire inputs between steps, and when to use HyperFrames stitching.
- [Zap.md Recipe Format: Fields, Inputs, and Validation Rules](https://docs.zap.wzrd.tech/concepts/zap-spec.md): Zap.md combines YAML frontmatter with Markdown prose. Learn every required field, input type, step reference, and validation rule.
- [Convex: Run State Tables, Schema, and Client Configuration](https://docs.zap.wzrd.tech/deployment/convex.md): Convex is Zap's source of truth for live run state. Learn the table schema, runtime flow, and how to configure and regenerate the Convex client.
- [Supabase Secrets: Encrypted BYOK Provider Key Setup](https://docs.zap.wzrd.tech/deployment/supabase-secrets.md): Configure Supabase for creator wallet auth and encrypted bring-your-own-key provider storage. Covers the migration, edge functions, and required secrets.
- [Deploy Zap to Vercel: Complete Production Setup Guide](https://docs.zap.wzrd.tech/deployment/vercel.md): Deploy the Zap Next.js app to Vercel with Node 24.x, configure environment variables, set up the poll drain endpoint, and run smoke tests.
- [Zap: Agent-First Framework for Generative Video Recipes](https://docs.zap.wzrd.tech/introduction.md): Zap is a lightweight content-agent framework for defining, validating, and running AI-powered generative video pipelines as portable recipe files.
- [GMI Cloud BYOK: Seedance 2.0 Live Video Generation](https://docs.zap.wzrd.tech/providers/gmi.md): Bring your own GMI Cloud API key to run Zap recipes against Seedance 2.0 — the flagship BytePlus video model — for T2V, I2V, and R2V generation.
- [Quickstart: Build Your First Zap Recipe in 5 Minutes](https://docs.zap.wzrd.tech/quickstart.md): Scaffold a Zap project from scratch, author a generative video recipe, validate it, and run a zero-cost mock pipeline in under five minutes.
- [Zap Agent Setup: Codex, Claude Code, and Cursor Guide](https://docs.zap.wzrd.tech/quickstart-agents.md): Point Codex, Claude Code, Cursor, or any coding agent at Zap's skill registry and CLI so it can author, validate, and run recipes autonomously.
- [Zap CLI Commands: Complete @wzrdtech/zap Reference Guide](https://docs.zap.wzrd.tech/reference/cli.md): Complete reference for all 16 zap commands: init, new, validate, lint, run, status, dev, studio, add, docs, skills, doctor, info, upgrade, and more.
- [Zap CLI Global Flags: Shared Options Across All Commands](https://docs.zap.wzrd.tech/reference/cli-flags.md): Reference for all Zap CLI flags: --json for machine-readable output, --live for provider spend, --input for recipe values, and --force.
- [Zap Runtime: Convex, Upstash, and Provider Execution](https://docs.zap.wzrd.tech/reference/runtime.md): How Zap executes live pipelines: Convex run state, Upstash poll queues, provider adapters, poll draining, HyperFrames stitching, and BYOK key retrieval.
- [Zap Recipe Schema Reference: Fields, Types, Defaults](https://docs.zap.wzrd.tech/reference/schema.md): Complete field reference for Zap.md frontmatter: every ZapSpec, ZapStep, and ZapStitch field, type, default, and constraint from @wzrdtech/core.
- [Zap Step Kinds: All 11 Pipeline Step Types Explained](https://docs.zap.wzrd.tech/reference/step-kinds.md): Reference for all 11 Zap step kinds with YAML examples, key fields, provider notes, and the complete model cost rate table from planner.ts.
- [Troubleshooting Zap: Node, Validation, and Run Errors](https://docs.zap.wzrd.tech/reference/troubleshooting.md): Fixes for the most common Zap errors: Node version issues, recipe validation, live run rejections, Supabase auth, and HyperFrames fallback behavior.
- [Connecting Your Wallet and Managing BYOK Provider Secrets](https://docs.zap.wzrd.tech/webapp/auth-secrets.md): Zap uses Thirdweb wallet signatures to authenticate creators and stores provider API keys encrypted in Supabase. Learn how to connect and manage your keys.
- [Gallery: Browsing Every Installed Zap Recipe](https://docs.zap.wzrd.tech/webapp/gallery.md): The gallery at /gallery lists every installed Zap recipe with title, description, budget, and a link to the one-click runner. It's the default entry point for creators.
- [Zap Web App: Routes, Auth Posture, and REST API Reference](https://docs.zap.wzrd.tech/webapp/overview.md): The Zap web app at zap.wzrd.tech hosts the creator runner, agent studio, gallery, docs, and REST API. Learn the route map and auth posture.
- [Run Status: Live Timeline at /runs/[runId]](https://docs.zap.wzrd.tech/webapp/run-status.md): The /runs/[runId] page streams live step-by-step progress from Convex, exposes per-step logs and output URLs, and links to the final Zap.mp4 asset.
- [Agent Studio: Eve-Powered Chat for Recipe Creation and Runs](https://docs.zap.wzrd.tech/webapp/studio.md): The Zap studio at /studio provides an Eve-powered chat interface where agents can author, validate, and run recipes interactively without touching the CLI.
- [Zap Runtime: One-Click Recipe Execution at /zap/[slug]](https://docs.zap.wzrd.tech/webapp/zap-runtime.md): The one-click creator runner at /zap/[slug] renders the recipe's declared inputs, quotes the run in real time, and dispatches mock or live pipelines from the browser.