Skip to content
Theatrical

@theatrical/cli

The CLI provides three commands for common developer workflows: scaffolding new projects, generating TypeScript types from an OpenAPI spec, and inspecting live API responses.

Install

Terminal window
npm install -g @theatrical/cli

Commands

theatrical init

Scaffold a new project from a template.

Terminal window
theatrical init my-booking-app --template react-ticketing

Options:

  • --template — starter template (default: react-ticketing)
  • --api-key — pre-configure your Vista API key

theatrical codegen

Generate TypeScript types and Zod schemas from an OpenAPI spec.

Terminal window
theatrical codegen ./openapi.yaml --output ./src/types/generated --zod

Options:

  • --output <dir> — output directory (default: ./src/generated)
  • --zod — include Zod schemas alongside the types

theatrical inspect

Explore live API responses with syntax highlighting and timing.

Terminal window
theatrical inspect sessions list --site site-001 --date 2026-04-20
theatrical inspect films search -q "Dune"
theatrical inspect sites get site-001