Skip to main content

hevlayer-layer-cli: operate Layer environments

Guide use of the layer CLI to inspect environments and work with indexes, pipelines, warehouses, UDFs and operations commands.

Source facts

Repository
hev/layer
Last source activity
September 27, 2026 at 15:41
Detected SKILL.md language
English
Stars
3
Forks
0

Uses

Use it for CLI operations; use the separate hevlayer-docs Skill when the task is only to consult documentation.

Limitations

Some supported commands delete indexes or install infrastructure, so the requested operation and target must be explicit.

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
name
hevlayer-layer-cli
description
Operate hev layer with the layer CLI. Use when the user asks an agent to inspect Layer environments, query docs through layer ask, list or get indexes, pipelines, warehouses, or UDFs, open the operations TUI, delete indexes, install Layer on AWS, or run Function manifests.
# hev layer CLI Use `layer` to operate hevlayer from the terminal. In a Layer checkout, prefer a repo-local binary: go build -o layer ./apps/layer-cli ./layer --help Use `./layer ...` for a repo-local binary and `layer ...` for one on `PATH`. Prefer `-o json` for agent parsing and do not print API keys. For docs questions, start with `layer ask` against the committed digest: layer ask grep "<query>" layer ask cat "<section-id>" layer ask tree layer ask glossary get "<term>" For read-only operational inspection, prefer: layer -o json env ls layer -o json env show [NAME] layer -o json index list layer -o json index get NAME layer -o json pipeline list layer -o json pipeline get ID layer -o json udf list layer -o json udf get UDF_ID `layer install` provisions a full AWS environment from a checkout — VPC, EKS, IAM/IRSA, S3, ECR via Terraform, then the Helm release. `layer install status` and `layer install uninstall` round out the lifecycle. It needs cloud credentials; confirm the account and profile before running it. Only `layer run` needs Kubernetes access by default. It applies a Function CR, registers the UDF spec with the gateway, triggers discovery, and optionally watches until the queue drains. Confirm the target environment, gateway URL, kube context, and Kubernetes namespace before mutating state. Mutating commands include `layer env add`, `layer env use`, `layer env rm`, `layer index delete`, `layer install`, `layer run`, and `layer run --rm`. Resolve configuration in this order: explicit flags, `LAYER_*` or `HEVLAYER_*` environment variables, `--env` or `LAYER_ENV`, the active `~/.hevlayer/config.toml` environment, then the built-in base URL.
View on GitHub