layer

Command-line interface for Layer — AI asset generation for game studios.

Pre-release. This is an early build of the rewritten CLI. Asset generation is landing next; today it covers signing in and choosing a workspace.

Install

uv tool install --prerelease=allow layer     # or: pipx install --pip-args=--pre layer

Working on the CLI itself? Install it from your checkout instead, so the layer command follows the branch you have out:

task -d apps/cli-py install-cli

Sign in

layer login                 # opens a browser
layer login --device        # for SSH sessions and containers
layer whoami
layer use my-studio

For CI and other unattended runs, set LAYER_API_KEY to a personal access token instead of signing in.

Where settings come from

Highest wins:

1. a command-line flag
2. an environment variable — LAYER_PROFILE, LAYER_WORKSPACE, LAYER_PROJECT, LAYER_API_URL, LAYER_API_KEY
3. layer.toml, found by walking up from the working directory
4. the active profile in ~/.layer/config.toml

Committing a layer.toml pins a checkout to its workspace, so two repos open in two terminals cannot generate into each other's:

workspace = "my-studio"
project   = "season-12-art"

Scripting

--json puts the result on stdout and nothing else — progress, warnings, and errors all go to stderr, so a pipeline never has to filter them out.

layer --json whoami | jq -r .workspace

Exit codes: 0 ok, 1 error, 2 usage, 3 auth, 4 insufficient balance, 5 invalid input, 6 content policy, 7 timeout.

Documentation

https://www.layer.ai/docs/cli

Licence

Apache-2.0