CLI commands

The Go CLI is a thin client for the hosted control plane. Run laminar <command> -h for command-specific flags.

Install

Install the current native CLI on macOS or Linux. The installer detects your operating system and architecture and verifies the downloaded archive before installing it to ~/.local/bin.

curl -fsSL https://laminar.rocks/install.sh | sh
laminar version

On Windows, run the checksum-verified download flow from PowerShell:

irm https://laminar.rocks/install.ps1 | iex
laminar version

Set LAMINAR_INSTALL_DIR before installation to choose a different binary directory. The current release is v0.2.0.

How the CLI works

The CLI authenticates with your Laminar account, links local code to a platform project, uploads deployment inputs, and reads backend-owned status. It does not deploy directly with a local AWS profile. Your organization must connect an AWS role before deployment.

Account

laminar login	Authenticate and store a backend-issued CLI token
laminar logout	Remove stored credentials
laminar whoami	Show the current account and API URL

Project configuration

laminar init	Create laminar.yml and an environment directory
laminar link [project-id]	Link the current directory to a platform project
laminar add <stage>	Add a stage to local configuration
laminar environments	List locally configured stages
laminar config normalize	Normalize local configuration

Deploy and operate

laminar deploy <stage>	Package the project and request a deployment
laminar deployments [stage]	List deployments
laminar rollback <stage>	Roll back through the platform API
laminar destroy <stage> --yes	Destroy a deployed stage
laminar health <stage>	Report stage health
laminar resources <stage>	Describe provisioned stage resources
laminar metrics <stage>	Read runtime metrics
laminar logs <stage>	Read or follow runtime logs
laminar invoke <stage>	Invoke a deployed function
laminar scale <stage>	Set Lambda concurrency

Environment

laminar env-pull <stage>	Write stage configuration to a local file
laminar env-push <stage>	Upload a local environment file to a stage

Quick start

laminar init --runtime go
laminar login --email you@example.com --password '...'
laminar link <project-id>
laminar deploy production
laminar logs production --follow

The default API URL is https://api.laminar.rocks/api/v1. Use LAMINAR_API_URL only when targeting another platform API, such as a local development environment.

CI/CD authentication

Store a backend-issued token and linked project ID in your workflow. AWS OIDC is optional for workflow-side checks; it does not replace the Laminar token used to authorize deployments.

LAMINAR_API_TOKEN=... LAMINAR_PROJECT_ID=... laminar deploy production