@tsuga/cli 1.57.0 → 1.59.0

package/README.md

@@ -272,6 +272,9 @@ tsuga dashboards get abc-123
 # List dashboards filtered by owner
 tsuga dashboards list -d '{"filters":{"owners":{"values":["team-1","team-2"]}}}'
 
+# List prod services of a team whose name contains "checkout"
+tsuga services list --envs prod --teams payments --search-query checkout
+
 # Get a specific service
 tsuga services get abc-123
 
@@ -592,6 +595,18 @@ tsuga install plugin codex
 
 Adds the `tsuga` marketplace (`tsuga-dev/agent-plugins`) and installs the `tsuga` plugin via the target CLI (`claude` / `codex` must be on `PATH`). For Claude Code, marketplace auto-update is enabled by patching `~/.claude/settings.json` with `extraKnownMarketplaces.tsuga.autoUpdate = true`; pass `--no-auto-update` to skip. Restart any running `claude` / `codex` sessions afterward.
 
+## Shared links
+
+Expand a short link copied from Logs or Traces, or a widget share link, and decode the query, filters, time range, cluster, and Analytics settings it carries. A full `app.tsuga.com` URL is decoded locally without an API call:
+
+```bash
+tsuga unshorten https://app.tsuga.com/l/<CODE>
+tsuga unshorten https://api.tsuga.com/v0/widget-shares/<ORG_ID>/<CODE>
+tsuga unshorten 'https://app.tsuga.com/explorer?query=level%3AERROR'
+```
+
+Malformed URL encoding or out-of-range timestamps produce a usage error (exit `2`). Exit `4` means the API returned an error; check the reported HTTP status. A `404` means the code is unknown, expired, or belongs to another organization.
+
 ## Documentation
 
 Search Tsuga documentation and the full API reference, then fetch a page by path: