Overview

@ambiten/create is the official scaffolding tool for the Ambiten platform.

It generates project structures, configuration, runtime wiring, and starter templates so applications begin with a consistent foundation instead of assembling infrastructure manually.

The generated projects follow Ambiten's execution model from day one, including runtime initialization, adapter integration, context propagation, multi-tenancy, logging, and optional GraphQL or Redis capabilities.

Installation

The CLI can be executed directly without a global installation.

npx @ambiten/create

Or installed locally:

npm install -D @ambiten/create

Quick Start

Create a new project interactively:

npx @ambiten/create init

Create a project with a name:

npx @ambiten/create init my-app

The CLI will guide you through runtime configuration and optional platform capabilities.

What the CLI Generates

Generated projects can include:

• REST APIs
• GraphQL APIs
• Next.js applications
• MERN applications
• Multi-tenant configurations
• Runtime logging
• Redis integration
• Garbage collection support
• Runtime adapters

The exact structure depends on the selected template and options.

Runtime Architecture

Projects generated by the CLI are aligned with the Ambiten execution model.

Bootstrap
    ↓
Adapter
    ↓
Context
    ↓
Models
    ↓
MongoDB

The CLI generates this structure automatically so applications begin from a consistent operational baseline.

Common Commands

Initialize a new project:

npx @ambiten/create init

Generate project artifacts:

npx @ambiten/create generate

Display available commands:

npx @ambiten/create --help

Relationship with Ambiten

@ambiten/create is the entry point into the Ambiten ecosystem.

The CLI scaffolds projects.

@ambiten/core provides the runtime.

@ambiten/logger provides structured telemetry and observability.

Together they create a consistent platform for building context-aware applications.

Documentation

Complete guides for project scaffolding, templates, runtime configuration, adapters, and deployment workflows are available at:

https://ambiten.dev

Philosophy

Infrastructure should be generated once and evolve consistently.

The purpose of the CLI is to help teams start with a coherent runtime architecture instead of assembling foundational infrastructure repeatedly across projects.

License

MIT