The official scaffolding CLI for building apps on top of LATTICE — the governed organization where humans and agents collaborate. Sets up a ready-to-run project with @autonomy-cloud/cast-sdk.

Quick start

npx create-cast-module@latest my-lattice-module
cd my-lattice-module
yarn cast dev

The scaffolder will:

1. Create a new project with TypeScript, linting, tests, and a preconfigured lattice CLI
2. Optionally start a local LATTICE server (Docker)
3. Open the browser for OAuth authentication

Options

| Flag | Description | | ------------------------------ | --------------------------------------- | | --example <name> | Initialize from an example | | --name <name> | Set the module name (skips the prompt) | | --display-name <displayName> | Set the display name (skips the prompt) | | --description <description> | Set the description (skips the prompt) | | --skip-local-instance | Skip the local server setup prompt |

By default (no flags), a minimal module is generated with core files and an integration test. Use --example to start from a richer example:

npx create-cast-module@latest my-lattice-module --example hello-world

Examples are sourced from latticehq/lattice/packages/cast-modules/examples.

Documentation

Full documentation is available at docs.latticeruntime.com/developers/extend/modules:

• Getting Started — step-by-step setup, project structure, server management, CI
• Building Apps — entity definitions, API clients, testing
• Publishing — deploy, npm publish, marketplace

Troubleshooting

• Server not starting: check Docker is running (docker info), then try yarn cast server logs.
• Auth not working: make sure you are logged in to LATTICE in the browser, then run yarn cast remote add.
• Types not generated: ensure yarn cast dev is running — it auto-generates the typed client.

Contributing

• See our GitHub
• Join our Discord