Reference
CLI command reference
Look up every Teml CLI command, argument, flag, output convention, and exit code.
This reference covers all 196 commands in the current Teml CLI. It is generated from the same Cobra command tree used by the binary, so command names, positional arguments, aliases, flags, and defaults stay aligned with the implementation.
For the exact manifest bundled into the version you installed, run:
teml docsHow commands behave
- Interactive terminals receive readable tables; redirected or piped output is JSON.
- Use
--output jsonor--output tableto choose explicitly. - Destructive commands never prompt. They require
--yesand fail without it. - Commands that accept structured bodies use
--json,--file path, or--file -for standard input. - The active project comes from
--project,TEML_PROJECT, or the selected profile, in that order. - API errors are written as one JSON object on standard error when output is non-interactive.
Global flags
Global flags can appear before or after a subcommand.
| Flag | Type/default | What it controls |
|---|---|---|
--api-key |
string | API key for headless auth (env: TEML_API_KEY) |
--api-url |
string | Edge API base URL (env: TEML_API_URL) |
--ingest-url |
string | ingest base URL for ‘teml send’ (env: TEML_INGEST_URL) |
--no-color |
bool; default: false | disable colored output |
-o, --output |
string | output format: table|json (default: table on a TTY, json when piped) |
--profile |
string | config profile to use (env: TEML_PROFILE) |
--project |
string | project id scope (env: TEML_PROJECT) |
Exit codes
| Code | Meaning |
|---|---|
0 |
success |
1 |
API or general error |
2 |
usage error (bad flags/arguments) |
3 |
unauthenticated (log in or set TEML_API_KEY) |
4 |
forbidden (credential lacks a required scope) |
5 |
not found |
Command catalog
Required positional arguments use angle brackets. Optional arguments use square brackets. Flags shown in the last column are command-specific; all global flags remain available.
accounts
| Command | What it does | Command-specific flags |
|---|---|---|
teml accounts get <group-type> <group-key> |
Show one account’s profile | — |
teml accounts list |
List accounts | –limit (int; default: 0) — maximum rows–offset (int; default: 0) — pagination offset–search (string) — search by key/name–type (string) — filter by group type (e.g. company) |
teml accounts timeline <group-type> <group-key> |
The account’s all-signal timeline (every member’s activity) | –cursor (string) — pagination cursor from the previous page–limit (int; default: 0) — maximum entries |
teml accounts types |
List the org’s group types with counts | — |
agent-runs
| Command | What it does | Command-specific flags |
|---|---|---|
teml agent-runs get <run-id> |
Show one run with its spans | — |
teml agent-runs list |
List agent runs | –agent (string) — filter by agent name–distinct-id (string) — filter to one person–env (string) — deployment environment scope–errors-only (bool; default: false) — only runs with errors–since (string; default: 24h) — start of the time window (30m, 6h, 7d)–until (string) — end of the time window (30m, 6h, 7d ago; default now) |
alerts
| Command | What it does | Command-specific flags |
|---|---|---|
teml alerts ack <alert-id> |
Acknowledge an alert Aliases: acknowledge. |
–note (string) — optional acknowledgment note |
teml alerts list |
List active alerts | –limit (int; default: 50) — maximum rows–severity (string) — filter by severity–state (string) — filter by state (firing, acknowledged, resolved) |
teml alerts resolve <alert-id> |
Manually resolve an alert | –note (string) — optional resolution note |
teml alerts rules create |
Create an alert rule (body = the rule JSON; see teml docs) |
–file (string) — request body from a JSON file (“-” for stdin)–json (string) — request body as inline JSON |
teml alerts rules delete <rule-id> |
Delete an alert rule | –yes (bool; default: false) — confirm this destructive operation (required) |
teml alerts rules get <rule-id> |
Show one alert rule | — |
teml alerts rules list |
List alert rules | –limit (int; default: 0) — maximum rows–offset (int; default: 0) — pagination offset–severity (string) — filter by severity |
teml alerts rules test <rule-id> |
Validate a rule and preview its query | — |
teml alerts rules update <rule-id> |
Update an alert rule (body must include the current version) |
–file (string) — request body from a JSON file (“-” for stdin)–json (string) — request body as inline JSON |
teml alerts silences create |
Create a silence (body: name, matchers[{label_name,operator,value}], starts_at, ends_at) | –file (string) — request body from a JSON file (“-” for stdin)–json (string) — request body as inline JSON |
teml alerts silences delete <silence-id> |
Expire a silence | –yes (bool; default: false) — confirm this destructive operation (required) |
teml alerts silences list |
List active silences | — |
anomalies
| Command | What it does | Command-specific flags |
|---|---|---|
teml anomalies ack <finding-id> |
Acknowledge a finding | — |
teml anomalies delete <finding-id> |
Delete a finding | –yes (bool; default: false) — confirm this destructive operation (required) |
teml anomalies get <finding-id> |
Show one finding | — |
teml anomalies list |
List anomaly findings | –limit (int; default: 0) — maximum rows–severity (string) — info|warning|critical–signal (string) — filter by signal–since (string) — start of the time window (30m, 6h, 7d)–status (string) — open|acknowledged|resolved–until (string) — end of the time window (30m, 6h, 7d ago; default now) |
teml anomalies resolve <finding-id> |
Resolve a finding | — |
apikey
| Command | What it does | Command-specific flags |
|---|---|---|
teml apikey create |
Create an API key (the secret is shown once) | –name (string) — display name for the key–scope (stringSlice; default: []) — scope to grant (repeatable), e.g. –scope logs:read |
teml apikey list |
List the org’s API keys | — |
teml apikey revoke <key-id> |
Revoke an API key | — |
teml apikey scopes |
List the grantable scope catalog | — |
channels
| Command | What it does | Command-specific flags |
|---|---|---|
teml channels create |
Create a channel (body: type, name, config{…}) | –file (string) — request body from a JSON file (“-” for stdin)–json (string) — request body as inline JSON |
teml channels delete <channel-id> |
Delete a channel | –yes (bool; default: false) — confirm this destructive operation (required) |
teml channels get <channel-id> |
Show one channel (secrets redacted) | — |
teml channels list |
List notification channels | — |
teml channels test <channel-id> |
Send a test notification through a channel | — |
teml channels update <channel-id> |
Update a channel (omitted secret fields keep their stored value) | –file (string) — request body from a JSON file (“-” for stdin)–json (string) — request body as inline JSON |
cohorts
| Command | What it does | Command-specific flags |
|---|---|---|
teml cohorts create |
Create a cohort (body: name, kind behavioral|property|static, definition?/members?) | –file (string) — request body from a JSON file (“-” for stdin)–json (string) — request body as inline JSON |
teml cohorts delete <cohort-id> |
Delete a cohort | –yes (bool; default: false) — confirm this destructive operation (required) |
teml cohorts get <cohort-id> |
Show one cohort | — |
teml cohorts list |
List cohorts | — |
teml cohorts members <cohort-id> |
List a cohort’s member person ids (paginated) | –cursor (string) — pagination cursor from the previous page–limit (int; default: 0) — maximum rows |
teml cohorts refresh <cohort-id> |
Recompute a cohort’s membership now | — |
teml cohorts update <cohort-id> |
Update a cohort (name/description/definition; kind is immutable) | –file (string) — request body from a JSON file (“-” for stdin)–json (string) — request body as inline JSON |
connections
| Command | What it does | Command-specific flags |
|---|---|---|
teml connections create |
Create a connection (body: provider, kind, display_name, secret) | –file (string) — request body from a JSON file (“-” for stdin)–json (string) — request body as inline JSON |
teml connections delete <connection-id> |
Delete a connection | –yes (bool; default: false) — confirm this destructive operation (required) |
teml connections get <connection-id> |
Show one connection (metadata only) | — |
teml connections list |
List connections | –provider (string) — filter by provider |
teml connections update <connection-id> |
Update a connection (rotate the secret / rename) | –file (string) — request body from a JSON file (“-” for stdin)–json (string) — request body as inline JSON |
dashboards
| Command | What it does | Command-specific flags |
|---|---|---|
teml dashboards clone <dashboard-id> |
Clone a dashboard | — |
teml dashboards create |
Create a dashboard (body: name, project_id, description?, layout?, tags?) | –file (string) — request body from a JSON file (“-” for stdin)–json (string) — request body as inline JSON |
teml dashboards delete <dashboard-id> |
Delete a dashboard | –yes (bool; default: false) — confirm this destructive operation (required) |
teml dashboards get <dashboard-id> |
Show a dashboard with its widgets | — |
teml dashboards list |
List dashboards | — |
teml dashboards update <dashboard-id> |
Update a dashboard (partial body; tags as {“values”:[…]}) | –file (string) — request body from a JSON file (“-” for stdin)–json (string) — request body as inline JSON |
teml dashboards widgets add <dashboard-id> |
Add a widget (body: type, title, query{…}, visualization?, refresh_interval?) | –file (string) — request body from a JSON file (“-” for stdin)–json (string) — request body as inline JSON |
teml dashboards widgets delete <dashboard-id> <widget-id> |
Delete a widget | –yes (bool; default: false) — confirm this destructive operation (required) |
teml dashboards widgets update <dashboard-id> <widget-id> |
Update a widget | –file (string) — request body from a JSON file (“-” for stdin)–json (string) — request body as inline JSON |
docs
| Command | What it does | Command-specific flags |
|---|---|---|
teml docs |
Print the full command manifest (JSON; –markdown for humans) | –api-key (string) — API key for headless auth (env: TEML_API_KEY)–api-url (string) — Edge API base URL (env: TEML_API_URL)-h, –help (bool; default: false) — help for docs–ingest-url (string) — ingest base URL for ‘teml send’ (env: TEML_INGEST_URL)–markdown (bool; default: false) — render the manifest as markdown–no-color (bool; default: false) — disable colored output-o, –output (string) — output format: table|json (default: table on a TTY, json when piped)–profile (string) — config profile to use (env: TEML_PROFILE)–project (string) — project id scope (env: TEML_PROJECT) |
doctor
| Command | What it does | Command-specific flags |
|---|---|---|
teml doctor |
Check API, auth, project, ingestion, and MCP connectivity | — |
escalation
| Command | What it does | Command-specific flags |
|---|---|---|
teml escalation create |
Create a policy (body: name, levels[{level,delay,channels,users,schedules}], max_escalations) | –file (string) — request body from a JSON file (“-” for stdin)–json (string) — request body as inline JSON |
teml escalation delete <policy-id> |
Delete a policy | –yes (bool; default: false) — confirm this destructive operation (required) |
teml escalation get <policy-id> |
Show one escalation policy | — |
teml escalation list |
List escalation policies | — |
teml escalation update <policy-id> |
Replace a policy (full body) | –file (string) — request body from a JSON file (“-” for stdin)–json (string) — request body as inline JSON |
evals
| Command | What it does | Command-specific flags |
|---|---|---|
teml evals config |
Show the eval configuration | — |
teml evals set-config |
Replace the eval configuration (body: enabled_metrics, judge_model, sampling_rate, …) | –file (string) — request body from a JSON file (“-” for stdin)–json (string) — request body as inline JSON |
export
| Command | What it does | Command-specific flags |
|---|---|---|
teml export create |
Create an export job (body: type EXPORT_TYPE_CSV|JSON|PARQUET + query) | –file (string) — request body from a JSON file (“-” for stdin)–json (string) — request body as inline JSON |
teml export jobs cancel <job-id> |
Cancel an export job | –yes (bool; default: false) — confirm this destructive operation (required) |
teml export jobs download-url <job-id> |
Get the signed download URL for a finished job | — |
teml export jobs get <job-id> |
Show one export job | — |
teml export jobs list |
List export jobs | –status (string) — filter by status enum name–type (string) — filter by type enum name |
teml export logs |
Export logs (body: format, service_name?, level?, start_time?, end_time?, columns?) | –file (string) — request body from a JSON file (“-” for stdin)–json (string) — request body as inline JSON |
flags
| Command | What it does | Command-specific flags |
|---|---|---|
teml flags create |
Create a flag (body: key, name?, active?, variants?, filters?; project_id injected) | –file (string) — request body from a JSON file (“-” for stdin)–json (string) — request body as inline JSON |
teml flags delete <flag-key> |
Delete a flag | –yes (bool; default: false) — confirm this destructive operation (required) |
teml flags get <flag-key> |
Show one flag’s full definition | — |
teml flags list |
List the project’s feature flags | — |
teml flags toggle <flag-key> <on|off> |
Turn a feature flag on or off | — |
teml flags update <flag-key> |
Update a flag (partial body; project_id injected) | –file (string) — request body from a JSON file (“-” for stdin)–json (string) — request body as inline JSON |
incidents
| Command | What it does | Command-specific flags |
|---|---|---|
teml incidents acknowledge <incident-id> |
Acknowledge an incident Aliases: ack. |
— |
teml incidents comment <incident-id> <text> |
Add a comment to the incident timeline | — |
teml incidents create <title> |
Declare an incident | –description (string) — incident description–link-ref (string) — primary signal reference id–link-type (string) — primary signal type: alert|error_group|anomaly–severity (int; default: 0) — severity 1 (SEV1) to 4 (SEV4) |
teml incidents delete <incident-id> |
Delete an incident | –yes (bool; default: false) — confirm this destructive operation (required) |
teml incidents link <incident-id> |
Link a signal (alert / error_group / anomaly) to an incident | –ref (string) — signal reference id (required)–type (string) — alert|error_group|anomaly (required) |
teml incidents list |
List incidents | –status (string) — filter by status: open|acknowledged|resolved |
teml incidents reopen <incident-id> |
Reopen a resolved incident | — |
teml incidents resolve <incident-id> |
Resolve an incident | — |
teml incidents unlink <incident-id> <link-id> |
Remove a linked signal | –yes (bool; default: false) — confirm this destructive operation (required) |
teml incidents update <incident-id> |
Edit an incident (body: title, description, severity) | –file (string) — request body from a JSON file (“-” for stdin)–json (string) — request body as inline JSON |
teml incidents view <incident-id> |
Show an incident’s case file (links + timeline) | — |
invitations
| Command | What it does | Command-specific flags |
|---|---|---|
teml invitations create <email> |
Invite someone to the org | –role (string) — role to grant (e.g. ROLE_MEMBER) |
teml invitations list |
List invitations | –status (string) — filter by status enum name |
teml invitations revoke <invitation-id> |
Revoke a pending invitation | –yes (bool; default: false) — confirm this destructive operation (required) |
issues
| Command | What it does | Command-specific flags |
|---|---|---|
teml issues affected <issue-id> |
The people and accounts an issue hit (blast radius) | –limit (int; default: 0) — maximum rows–offset (int; default: 0) — pagination offset |
teml issues assign <issue-id> [user-id] |
Assign an issue to a member (or –unassign) | –unassign (bool; default: false) — clear the assignee |
teml issues ignore <issue-id> |
Ignore an issue | — |
teml issues list |
List issues | –env (string) — filter by deployment environment–limit (int; default: 30) — maximum rows–service (string) — filter by service name–since (string) — start of the time window (30m, 6h, 7d)–status (string) — filter by status: new|ongoing|resolved|ignored|snoozed–until (string) — end of the time window (30m, 6h, 7d ago; default now) |
teml issues merge <canonical-issue-id> |
Merge duplicate issues into a canonical one | –source (stringSlice; default: []) — issue id to merge in (repeatable) |
teml issues merged-sources <canonical-issue-id> |
The issues merged into a canonical one | — |
teml issues occurrences <issue-id> |
An issue’s occurrence time series | –interval (string) — bucket size–since (string; default: 24h) — start of the time window (30m, 6h, 7d)–until (string) — end of the time window (30m, 6h, 7d ago; default now) |
teml issues releases <issue-id> |
An issue’s per-release context and breakdown | — |
teml issues resolve <issue-id> |
Mark an issue resolved | –in-next-release (bool; default: false) — resolve in the next release (regression re-opens it) |
teml issues search |
Search raw error events (occurrences, not groups) | –level (string) — filter by level–limit (int; default: 0) — maximum rows-q, –query (string) — full-text query–service (string) — filter by service name–since (string; default: 24h) — start of the time window (30m, 6h, 7d)–until (string) — end of the time window (30m, 6h, 7d ago; default now) |
teml issues snooze <issue-id> |
Snooze (archive-until) an issue | –escalating (bool; default: false) — wake when the issue escalates (spike)–for (string) — snooze for a duration (30m, 6h, 7d)–forever (bool; default: false) — snooze forever–occurrences (int; default: 0) — wake after N more events–users (int; default: 0) — wake after N more affected users |
teml issues unmerge <source-issue-id> |
Restore a previously merged issue | — |
teml issues view <issue-id> |
Show one issue’s detail | — |
llm
| Command | What it does | Command-specific flags |
|---|---|---|
teml llm pricing delete <model> |
Remove a model’s pricing override | –yes (bool; default: false) — confirm this destructive operation (required) |
teml llm pricing list |
List pricing overrides | — |
teml llm pricing set <model> |
Set a model’s pricing (body: input_cost_per_token, output_cost_per_token, …) | –file (string) — request body from a JSON file (“-” for stdin)–json (string) — request body as inline JSON |
teml llm series |
Bucketed LLM cost time series | –interval (string; default: 1h) — bucket size (1h, 6h, 1d)–since (string; default: 7d) — start of the time window (30m, 6h, 7d)–until (string) — end of the time window (30m, 6h, 7d ago; default now) |
teml llm summary |
Org LLM cost summary (by model, by agent) | –since (string; default: 7d) — start of the time window (30m, 6h, 7d)–until (string) — end of the time window (30m, 6h, 7d ago; default now) |
teml llm top-persons |
The people your LLM spend goes to | –limit (int; default: 0) — maximum rows–since (string; default: 7d) — start of the time window (30m, 6h, 7d)–until (string) — end of the time window (30m, 6h, 7d ago; default now) |
login
| Command | What it does | Command-specific flags |
|---|---|---|
teml login |
Log in via your browser (device flow) | –no-browser (bool; default: false) — print the verification URL instead of opening a browser |
logout
| Command | What it does | Command-specific flags |
|---|---|---|
teml logout |
Log out (clear the stored session for the profile) | — |
logs
| Command | What it does | Command-specific flags |
|---|---|---|
teml logs aggregate |
Count logs grouped by a dimension | –group-by (string) — dimension to group by (required)–since (string) — time window (30m, 6h, 7d) |
teml logs context |
Logs surrounding an anchor (by –timestamp + –service) | –after (int; default: 0) — records after the anchor–before (int; default: 0) — records before the anchor–service (string) — anchor log’s service–timestamp (string) — anchor log timestamp, RFC3339Nano (required) |
teml logs fields |
Filterable log fields and their values | –since (string; default: 24h) — start of the time window (30m, 6h, 7d)–until (string) — end of the time window (30m, 6h, 7d ago; default now) |
teml logs patterns |
Detected log pattern clusters | –level (string) — filter by severity–limit (int; default: 0) — maximum clusters–min-count (int; default: 0) — minimum cluster size–service (string) — filter by service name–since (string; default: 24h) — start of the time window (30m, 6h, 7d)–until (string) — end of the time window (30m, 6h, 7d ago; default now) |
teml logs query |
Search logs | –distinct-id (string) — filter to one person’s distinct_id–env (string) — filter by deployment environment–level (string) — filter by level (error, warn, info, …)–limit (int; default: 50) — maximum rows-q, –query (string) — full-text query–service (string) — filter by service name–since (string; default: 1h) — start of the time window (30m, 6h, 7d)–until (string) — end of the time window (30m, 6h, 7d ago; default now) |
teml logs tail |
Live-tail logs (SSE); Ctrl-C to stop | –distinct-id (string) — filter to one person’s distinct_id–env (string) — filter by deployment environment–level (string) — filter by level (error, warn, info, …)-q, –query (string) — full-text query–service (string) — filter by service name |
mcp
| Command | What it does | Command-specific flags |
|---|---|---|
teml mcp endpoint |
Print the MCP Streamable HTTP endpoint without credentials | — |
teml mcp verify |
Run a read-only MCP initialize handshake | — |
members
| Command | What it does | Command-specific flags |
|---|---|---|
teml members list |
List org members | — |
teml members remove <user-id> |
Remove a member from the org | –yes (bool; default: false) — confirm this destructive operation (required) |
teml members set-role <user-id> <role> |
Change a member’s role (e.g. ROLE_ADMIN, ROLE_MEMBER) | — |
metrics
| Command | What it does | Command-specific flags |
|---|---|---|
teml metrics delete <metric-name> |
Delete a metric’s datapoints | –yes (bool; default: false) — confirm this destructive operation (required) |
teml metrics forecast <metric-name> |
Forecast a metric (expected band + horizon) | –env (string) — deployment environment scope–horizon (string) — forecast horizon–interval (string) — bucket size–service (string) — filter by service name |
teml metrics labels <metric-name> |
A metric’s labels and their values | –since (string; default: 24h) — start of the time window (30m, 6h, 7d)–until (string) — end of the time window (30m, 6h, 7d ago; default now) |
teml metrics list |
List the available metric names | — |
teml metrics query <metric-name> |
Run a bucketed aggregation over a metric | –agg (string; default: avg) — aggregation: avg|sum|min|max|count|p50|p95|p99–env (string) — filter by deployment environment–group-by (stringSlice; default: []) — group by dimensions: service_name, environment, instance, job–interval (string; default: 5m) — bucket size: 1m,5m,15m,30m,1h,6h,12h,1d–since (string; default: 1h) — start of the time window (30m, 6h, 7d)–until (string) — end of the time window (30m, 6h, 7d ago; default now) |
oncall
| Command | What it does | Command-specific flags |
|---|---|---|
teml oncall contact-methods add |
Add a contact method | –label (string) — display label–type (string) — email|slack_dm|sms|phone (required)–value (string) — the address / number / handle (required) |
teml oncall contact-methods delete <method-id> |
Delete a contact method | –yes (bool; default: false) — confirm this destructive operation (required) |
teml oncall contact-methods list |
List your contact methods | — |
teml oncall now <schedule-id> |
Who is on call right now (or –at a time) | –at (string) — evaluate at this RFC3339 time (default now) |
teml oncall overrides create <schedule-id> |
Create an override | –end (string) — override end, RFC3339 (required)–start (string) — override start, RFC3339 (required)–user (string) — user id taking the shift (required) |
teml oncall overrides delete <override-id> |
Delete an override | –yes (bool; default: false) — confirm this destructive operation (required) |
teml oncall overrides list <schedule-id> |
List a schedule’s overrides | — |
teml oncall schedules create |
Create a schedule (body: name, layers[{name,users,rotation_length,start_at,…}]) | –file (string) — request body from a JSON file (“-” for stdin)–json (string) — request body as inline JSON |
teml oncall schedules delete <schedule-id> |
Delete a schedule | –yes (bool; default: false) — confirm this destructive operation (required) |
teml oncall schedules get <schedule-id> |
Show one schedule | — |
teml oncall schedules list |
List schedules | — |
teml oncall schedules update <schedule-id> |
Replace a schedule (full body) | –file (string) — request body from a JSON file (“-” for stdin)–json (string) — request body as inline JSON |
persons
| Command | What it does | Command-specific flags |
|---|---|---|
teml persons get <person-id-or-distinct-id> |
Show one person’s profile and cross-signal stats | — |
teml persons search [query] |
Search persons by email / name / distinct_id | –limit (int; default: 25) — maximum rows |
teml persons stats <person-id-or-distinct-id> |
A person’s cross-signal counters | — |
teml persons timeline <person-id-or-distinct-id> |
Show a person’s cross-signal timeline (newest first) | –before (string) — paginate: entries before this cursor–limit (int; default: 50) — maximum entries |
projects
| Command | What it does | Command-specific flags |
|---|---|---|
teml projects create <name> |
Create a project | –description (string) — project description–slug (string) — immutable project slug (required) |
teml projects current |
Show the effective project scope | — |
teml projects delete <project-id> |
Delete a project and its scoping | –yes (bool; default: false) — confirm this destructive operation (required) |
teml projects list |
List the org’s projects | — |
teml projects update <project-id> |
Rename a project / edit its description | –description (string) — new description (empty string clears it)–name (string) — new display name |
teml projects use <project-id-or-slug> |
Set the profile’s default project scope | — |
releases
| Command | What it does | Command-specific flags |
|---|---|---|
teml releases create <release> |
Register a release/deploy | –author (string) — deploy author–commit (string) — commit SHA–deploy-at (string) — deploy time, RFC3339 (default now)–ref (string) — branch or tag–url (string) — link to the release/CI run |
teml releases get <release> |
Show one release’s detail (new/regressed issues, blast radius) | — |
teml releases list |
List releases with error/regression counts | — |
replay
| Command | What it does | Command-specific flags |
|---|---|---|
teml replay delete <session-id> |
Delete a recording | –yes (bool; default: false) — confirm this destructive operation (required) |
teml replay for-trace <trace-id> |
Find the session recording covering a trace | — |
teml replay get <session-id> |
Show one recording’s metadata | — |
teml replay list |
List recordings | — |
teml replay related <session-id> |
Errors and events that happened during the session | — |
teml replay snapshots <session-id> |
Dump the recording’s rrweb events (decoded JSON) | — |
saved-searches
| Command | What it does | Command-specific flags |
|---|---|---|
teml saved-searches create |
Create a saved search (body: name, signal, query{…}, is_shared) | –file (string) — request body from a JSON file (“-” for stdin)–json (string) — request body as inline JSON |
teml saved-searches delete <search-id> |
Delete a saved search | –yes (bool; default: false) — confirm this destructive operation (required) |
teml saved-searches list |
List saved searches | –signal (string) — filter by signal (logs, traces, errors, …) |
teml saved-searches update <search-id> |
Update a saved search | –file (string) — request body from a JSON file (“-” for stdin)–json (string) — request body as inline JSON |
scores
| Command | What it does | Command-specific flags |
|---|---|---|
teml scores add <run-id> |
Submit a human score for an agent run | –comment (string) — free-text comment–label (string) — score label (required)–name (string) — score dimension name–value (float64; default: 0) — numeric score value |
teml scores list <run-id> |
List an agent run’s scores (human + judge) | — |
search
| Command | What it does | Command-specific flags |
|---|---|---|
teml search correlate <trace-id> |
Everything correlated with a trace (logs, errors, metrics) | –include (stringSlice; default: []) — signals to include: logs,errors,metrics (default all) |
teml search filters <field> |
Distinct values of a filterable field | — |
teml search unified <query> |
Search traces, logs, and metrics with one query | –limit (int; default: 0) — maximum hits per signal–service (string) — filter by service name–since (string) — time window (30m, 6h, 7d)–types (stringSlice; default: []) — signal types: traces,logs,metrics (default all) |
segments
| Command | What it does | Command-specific flags |
|---|---|---|
teml segments create |
Create a segment (body: name, group_type, filters[{field,op,value}]) | –file (string) — request body from a JSON file (“-” for stdin)–json (string) — request body as inline JSON |
teml segments delete <segment-id> |
Delete a segment | –yes (bool; default: false) — confirm this destructive operation (required) |
teml segments list |
List account segments | — |
teml segments preview <segment-id> |
Preview the accounts a segment currently matches | — |
teml segments update <segment-id> |
Update a segment | –file (string) — request body from a JSON file (“-” for stdin)–json (string) — request body as inline JSON |
send
| Command | What it does | Command-specific flags |
|---|---|---|
teml send event <event-name> |
Send one product event (capture) | –distinct-id (string) — the person’s distinct_id (required)–properties (string) — event properties as a JSON object–session-id (string) — optional session id |
services
| Command | What it does | Command-specific flags |
|---|---|---|
teml services list |
Per-service RED snapshot (error_rate is a 0..1 fraction) | –env (string) — deployment environment scope–since (string; default: 1h) — start of the time window (30m, 6h, 7d)–until (string) — end of the time window (30m, 6h, 7d ago; default now) |
teml services red <service-name> |
One service’s RED time series | –env (string) — deployment environment scope–interval (string) — bucket size (1m, 5m, 1h)–since (string; default: 1h) — start of the time window (30m, 6h, 7d)–until (string) — end of the time window (30m, 6h, 7d ago; default now) |
settings
| Command | What it does | Command-specific flags |
|---|---|---|
teml settings config delete <config-row-id> |
Delete a configuration entry by its row id (see list) | –yes (bool; default: false) — confirm this destructive operation (required) |
teml settings config get <key> |
Show one configuration entry | — |
teml settings config list |
List configuration entries | –type (string) — filter by config type |
teml settings config set <key> |
Set a configuration entry (body: config_value, config_type?) | –file (string) — request body from a JSON file (“-” for stdin)–json (string) — request body as inline JSON |
teml settings github get |
Show the GitHub config | — |
teml settings github set |
Set the GitHub config | –enabled (bool; default: true) — enable suspect-commit blame–repo (string) — repository “owner/name” (required)–repo-root (string) — monorepo subpath the service lives under |
skill
| Command | What it does | Command-specific flags |
|---|---|---|
teml skill install <claude|codex|cursor|gemini> |
Write the skill where the agent discovers it | –global (bool; default: false) — codex: install into ~/.codex/AGENTS.md instead of ./AGENTS.md–project (bool; default: false) — claude: install into ./.claude/skills (this repo) instead of ~/.claude/skills |
teml skill show |
Print the canonical skill markdown | — |
symbols
| Command | What it does | Command-specific flags |
|---|---|---|
teml symbols upload-dsym <file> |
Upload an iOS dSYM binary | — |
teml symbols upload-proguard <mapping.txt> |
Upload an Android ProGuard/R8 mapping | –dist (string) — optional distribution qualifier–release (string) — release the mapping belongs to (required) |
teml symbols upload-sourcemap |
Upload a JS sourcemap bundle (body: release, files…) | –file (string) — request body from a JSON file (“-” for stdin)–json (string) — request body as inline JSON |
tickets
| Command | What it does | Command-specific flags |
|---|---|---|
teml tickets create <issue-id> |
Create a provider ticket from an issue | –provider (string) — jira|linear|github (required)–repo (string) — GitHub repository “owner/name” (GitHub only) |
teml tickets list <issue-id> |
List an issue’s linked tickets | — |
teml tickets unlink <ticket-id> |
Unlink a ticket (the provider ticket itself is kept) | –yes (bool; default: false) — confirm this destructive operation (required) |
traces
| Command | What it does | Command-specific flags |
|---|---|---|
teml traces critical-path <trace-id> |
The trace’s latency-critical span path | — |
teml traces delete <trace-id> |
Delete a trace’s spans | –yes (bool; default: false) — confirm this destructive operation (required) |
teml traces get <trace-id> |
Show a trace’s spans | — |
teml traces search |
Search traces | –distinct-id (string) — only traces touching this person–env (string) — filter by deployment environment–limit (int; default: 30) — maximum rows–operation (string) — filter by operation name–service (string) — filter by service name–since (string; default: 1h) — time window (30m, 6h, 7d) |
teml traces service-map |
Service dependency topology built from traces | –since (string; default: 1h) — start of the time window (30m, 6h, 7d)–until (string) — end of the time window (30m, 6h, 7d ago; default now) |
teml traces stats <trace-id> |
Aggregate statistics for one trace | — |
usage
| Command | What it does | Command-specific flags |
|---|---|---|
teml usage |
Show the org’s usage meters (events, metric series, replay sessions) | –period (string) — billing period YYYY-MM (default: current month) |
whoami
| Command | What it does | Command-specific flags |
|---|---|---|
teml whoami |
Show the authenticated identity | — |
Discover one command interactively
Append --help at any level to see the same information in the terminal:
teml issues --help
teml incidents create --help