Use the Teml CLI

Investigate and operate Teml from a terminal or coding agent.

The Teml CLI provides scriptable access to customer timelines, Issues, logs, traces, alerts, and the rest of the public platform surface.

Install

go install github.com/getteml/teml/cli@latest

Use @main only when testing the current source before a tagged CLI release.

Authenticate

Humans can use the browser device flow:

teml login
teml whoami

For CI or an AI agent, use a narrowly scoped API key:

export TEML_API_KEY="tm_..."
teml doctor

Select a project

teml projects use my-app

Commands use that project until you override it with a flag or profile.

Investigate a customer

teml persons search buyer@acme.example
teml persons timeline <person-id>
teml issues list --status new
teml issues affected <issue-id>
teml logs query --level error --since 1h

Pipe output to another process to receive JSON. Interactive terminals receive readable tables.

Give the CLI to an agent

teml skill install claude
teml skill install codex
teml skill install cursor
teml docs

The generated command manifest lets an agent discover the installed CLI instead of relying on a copied command list.

Look up commands and flags

Every command supports --help. Use it at the group or leaf level:

teml issues --help
teml incidents create --help

The CLI command reference lists all current commands with their positional arguments, aliases, command-specific flags, defaults, and behavior. It is generated from the same command tree as teml docs, so it is not a manually maintained shortlist.

Writes and automation

Destructive CLI commands require an explicit --yes. In CI, use a dedicated key, a fixed project, and JSON output. Never give an automation a human administrator key.