tsuga-cli

Manage Tsuga resources and run TQL-scoped telemetry queries from the terminal.

2|Updated May 28, 2026
One-click install
npx skills add https://github.com/tsuga-dev/agent-plugins --skill tsuga-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tsuga-cli
Source: https://github.com/tsuga-dev/agent-plugins/tree/main/plugins/tsuga/skills/tsuga-cli
Command: npx skills add https://github.com/tsuga-dev/agent-plugins --skill tsuga-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill solves the problem of operating Tsuga resources and investigating telemetry data without leaving the terminal, so you can move from an alert or question to concrete evidence quickly.

Core Features & Use Cases

  • Resource management for Tsuga objects: Create, update, delete, list, and read Tsuga entities (dashboards, monitors, teams, routes, notification rules/silences, ingestion API keys, retention/tag policies, quality reports, cloud resources, etc.), including JSON body generation and stdin/file inputs.
  • Telemetry discovery and investigation: Search logs and traces with TQL filters, query metrics and build aggregations (scalar/timeseries), and derive service dependency graphs from trace spans.
  • Correct routing via playbooks for common lookups: Supports two specific lookups—service ownership/context and reliability posture/quality scores—by loading structured playbooks from references.

Quick Start

Use tsuga-cli to search errors for a service over the last hour by running the command you need with an explicit TQL query and a time window.

Frequently Asked Questions about tsuga-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I query logs and traces from the command line using TQL filters?

Build metrics aggregations by writing JSON request bodies for scalar or timeseries answers, ensuring correct JSON-body formats and consistent time-range handling to return aggregated telemetry data.

Can I manage Tsuga dashboards and monitors via CLI CRUD operations?

Generate deep links to Tsuga app pages by constructing correct routing URLs, allowing you to share or navigate directly to specific telemetry views and investigation contexts from the command line.

What is the best way to find service ownership and reliability posture scores in Tsuga?

Find service ownership and reliability posture scores by loading structured playbooks from references, which route common lookups to return service context and quality score data accurately.

How does command-line telemetry investigation handle safe mutations and secret-free filtering?

Command-line telemetry investigation handles safe mutations and secret-free filtering by applying authorized CRUD operations and secure TQL filter syntax guidance to prevent exposing sensitive data during queries.