Skip to main content
The atmn CLI lets you define your pricing plans in code via an autumn.config.ts file, and sync them to Autumn with a single command.

Installation

Run the CLI directly with your package manager:
bunx atmn

Login

Authenticate with your Autumn account:
bunx atmn login
This opens your browser, lets you pick an organization, and saves API keys for both sandbox and production to your .env file:
.env
AUTUMN_SECRET_KEY=am_sk_test_...
AUTUMN_PROD_SECRET_KEY=am_sk_live_...
You can verify your setup at any time with bunx atmn env, which shows your current organization and environment.

Initialize a project

Run atmn init in your project root to create an autumn.config.ts file:
bunx atmn init
You’ll be prompted to choose a starter template:
TemplatePricing model
T3 ChatFreemium with message limits and a credits add-on
RailwayCredit-based infrastructure pricing with overage
LinearPer-seat pricing with team limits
OpenAICredit system mapping multiple AI models
Pick whichever is closest to your use case, or start from scratch and build your own using the config reference.

Push and pull

Once you have an autumn.config.ts, sync it with Autumn:
# Push local config to Autumn
bunx atmn push

# Pull remote config into your local file
bunx atmn pull
push reads your config file, compares it with what’s in Autumn, and applies the changes. In interactive mode you’ll see a summary of what will be created, updated, or deleted before confirming. pull fetches your plans and features from Autumn and writes them into your local autumn.config.ts. If the file already exists, it does a smart in-place update that preserves your local formatting and comments where possible.
Use bunx atmn pull to generate an autumn.config.ts from plans you’ve already created in the dashboard.

Preview locally

You can preview your plans without pushing anything:
bunx atmn preview
This renders a pricing table from your local config.

Environments

By default, all commands target your sandbox environment. Add the -p flag to target production:
# Push to production
bunx atmn push -p

# Pull from production
bunx atmn pull -p
Pushing to production will prompt for confirmation. Use --yes to skip the prompt automatically.
Next: Configuration reference Learn how to define features, plans, and pricing in your autumn.config.ts.

Configuration reference

Complete reference for features, plans, and plan features