TrueWatch is Now Live on Google Cloud Marketplace
TrueWatch Awarded a 2025 AWS Partner Award
TrueWatch
Get Started
A red bird flying over a glowing river through a forest valley

OWL CLI

Query and manage TrueWatch from your terminal.

Query logs, metrics, traces and incidents, manage dashboards and monitors, and script your routine checks. You and your AI tools run the same commands, within the permissions of your API key.

Get startedBook a demo

Paste this into an AI tool that can run terminal commands. It installs OWL CLI and OWL Skill for you.

Read https://static.truewatch.com/owl/skill.en.md, and install and configure OWL CLI and OWL Skill in the current environment according to the document.

Installation parameters:
OWL_REGISTRY_ENDPOINT="<OWL_REGISTRY_ENDPOINT>"
OWL_TEMP_CODE="<YOUR_TEMP_CODE>"

Replace <OWL_REGISTRY_ENDPOINT> with the endpoint for your workspace's site, and <YOUR_TEMP_CODE> with a temporary authorization code from the TrueWatch console.

Endpoints by region →Installation command →

Your API key never appears in the conversation.

WORKS WITH YOUR AI TOOLS

Works with the AI tools your team already uses.

Any AI tool that can run terminal commands can use OWL CLI. OWL Skill tells it which commands to run.

  • Claude Code logoClaude Code
  • Codex logoCodex
  • Cursor logoCursor
  • Trae logoTrae
  • GitHub Copilot logoGitHub Copilot
  • Windsurf logoWindsurf
WHAT YOU CAN DO

Your daily observability work, in one CLI.

Query data, work incidents and manage dashboards with the same commands, whether you type them or your AI tool does.

Query any data

$ ▍

Find sources and fields, then run full DQL across metrics, logs, RUM, APM, network, profiling and billing data.

Work an incident

$ owl exec owl.incident.list▍

Read incidents and related events, check the operation log and add progress comments.

Manage dashboards

CLI only
$ owl exec owl.dashboard.get --dashboard_uuid▍

Create a dashboard, replace one or read its configuration, straight from a script.

Analyze profiles

CLI only
$ owl show owl.profiling.parse▍

Get a profile summary, then parse the full stack.

Switch customers and sites

$ owl switch customer-a▍

Move between customers, sites or environments with one command, and query any workspace you're authorized for.

Runbooks and monitors

$ owl exec owl.nbook_note.list --type runbook▍

Search, read and update notes, runbooks and monitors.

13 tool categories in one CLI.

See every tool

QUICK START

From install to first result in two commands.

  • Run owl sync to get your workspace's tools.
  • Run owl exec owl.data.show_dql_namespace -f json to list the data you can query.
  • Installed manually? Run owl init and owl login first.
Read the full quick start
Terminal · step 1
Running…
$ ▍
Your workspace's tools are ready to use.
Terminal · step 2
Ready
$ ▍
ReadyFirst result from TrueWatchTwo commands · for you and your agents
DOCUMENTATION

Know what you need? Go straight to it.

Get set up

Daily work

Reference

FAQs

Questions about OWL CLI, answered.

No. When an AI tool installs OWL CLI for you, it uses a short-lived temporary code, swaps it for a key and writes the key to your local config without showing it.

Security notes

EXPLORE MORE WITH TRUEWATCH AI

Get more done with the AI that knows your systems.

  • OWL MCP Server

    Connect your AI client to TrueWatch data and tools, within the permissions you set.

    Explore product

  • Toby AI Agents

    Give each agent a role and a scope. Approve what it proposes before anything changes.

    Explore product

  • Toby AI TruePilot

    Ask in plain language. Analyze your current view and build dashboards with AI assistance.

    Explore product

  • AI Agent Observability

    Trace agent steps, model calls and tool execution to investigate latency, cost and risk events.

    Explore product
GUIDES & INSIGHTS

Keep up with what's next in observability and AI.

View all articles
A red owl on a lakeside dock in a forest at dawn

Bring TrueWatch into your terminal.

Install it yourself or let your AI tool do it, then get your first result in two commands.

Get startedBook a demo