---
title: DSL reference
description: Canonical Cuitty DSL blocks and adapter targets.
section: DSL
order: 2
updatedAt: 2026-06-05
slug: dsl/reference
---
# DSL reference

The canonical file extension is `.cuitty`. Bare `.cuitty` files, `.cuitty.hcl`,
`.ctest`, and `.cuitty/**/*.hcl` are detected by the Cuitty DSL tooling and LSP.

| Block | Product | Purpose |
| --- | --- | --- |
| `cuitty` | Core | Schema version, project metadata, enabled extensions, export targets. |
| `test_suite` | Tests | HTTP, gRPC, Pilot, and unit test workflows. |
| `playbook` | Pilot | Browser automation and provider operations. |
| `video` | Video | Declarative composition timelines and output settings. |
| `code_app` | Code | App manifests, permissions, ownership, and runtime. |
| `module` | Observe | Module registry and portal metadata. |
| `persist` | Persist | Storage profiles and adapter configuration. |

Adapter targets keep product runtimes stable while authoring converges:

```bash
cuitty-dsl export --target ctest examples/tests/auth-flow.cuitty
cuitty-dsl export --target pilot-yaml examples/pilot/cloudflare-dns.cuitty
cuitty-dsl export --target video-yaml examples/video/code-demo.cuitty
```