---
title: DSL quickstart
description: Start authoring Cuitty product workflows with .cuitty files.
section: DSL
order: 1
updatedAt: 2026-06-05
slug: dsl/quickstart
---
# DSL quickstart

Cuitty DSL is an HCL-style language for product workflows across Cuitty. A
single `.cuitty` file can declare project metadata, test suites, Pilot
playbooks, Video compositions, Code Apps, modules, and adapter targets.

```hcl
cuitty {
  schema_version = 1
  project = "demo"
  extensions = ["tests", "pilot", "video"]
  targets = ["ctest", "pilot-yaml", "video-yaml"]
}

test_suite "smoke" {
  test "health" {
    type = "http"
    request {
      method = "GET"
      url = "${env.BASE_URL}/api/health"
    }
    assert { status = 200 }
  }
}
```

Open the hosted playground at [/playground/dsl](/playground/dsl), or run the
local sandbox:

```bash
cd ~/Code/cuitty/dsl
./run sandbox
```

The playground validates source, shows diagnostics, lists symbols, and exposes
the normalized AST that adapters use.