@mux/cli 0.7.1 → 1.0.0-beta.1

package/README.md

@@ -1,393 +1,1377 @@
-# mux-cli
-
-Your friendly neighborhood Mux CLI tool. **Requires Node 14 or newer.**
-
-[![oclif](https://img.shields.io/badge/cli-oclif-brightgreen.svg)](https://oclif.io)
-[![Version](https://img.shields.io/npm/v/@mux/cli.svg)](https://npmjs.org/package/@mux/cli)
-[![Downloads/week](https://img.shields.io/npm/dw/@mux/cli.svg)](https://npmjs.org/package/@mux/cli)
-[![License](https://img.shields.io/npm/l/@mux/cli.svg)](https://github.com/muxinc/cli/blob/master/package.json)
-
-<!-- toc -->
-* [mux-cli](#mux-cli)
-* [Usage](#usage)
-* [Commands](#commands)
-<!-- tocstop -->
-
-# Usage
-
-<!-- usage -->
-```sh-session
-$ npm install -g @mux/cli
-$ mux COMMAND
-running command...
-$ mux (-v|--version|version)
-@mux/cli/0.7.1 darwin-x64 node-v14.17.5
-$ mux --help [COMMAND]
-USAGE
-  $ mux COMMAND
+# Mux CLI
+
+A command-line interface for interacting with the Mux API, designed to provide a first-class development experience for working with Mux services locally.
+
+## Installation
+
+### Install via npm
+
+```bash
+npm install -g @mux/cli
+```
+
+Or run directly with npx:
+
+```bash
+npx @mux/cli@latest
+```
+
+### Shell installer
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/muxinc/cli/master/install.sh | bash
+```
+
+### Download the binary
+
+Download the latest binary for your platform from [GitHub Releases](https://github.com/muxinc/cli/releases):
+
+```bash
+# macOS (Apple Silicon)
+curl -L https://github.com/muxinc/cli/releases/latest/download/mux-darwin-arm64 -o mux
+chmod +x mux
+sudo mv mux /usr/local/bin/
+
+# macOS (Intel)
+curl -L https://github.com/muxinc/cli/releases/latest/download/mux-darwin-x64 -o mux
+chmod +x mux
+sudo mv mux /usr/local/bin/
+
+# Linux (x64)
+curl -L https://github.com/muxinc/cli/releases/latest/download/mux-linux-x64 -o mux
+chmod +x mux
+sudo mv mux /usr/local/bin/
+
+# Linux (arm64)
+curl -L https://github.com/muxinc/cli/releases/latest/download/mux-linux-arm64 -o mux
+chmod +x mux
+sudo mv mux /usr/local/bin/
+```
+
+The binary is self-contained and has no dependencies.
+
+## Getting Started
+
+### Authentication
+
+Before using the Mux CLI, you need to authenticate with your Mux API credentials. You can obtain these from the [Mux Dashboard](https://dashboard.mux.com/settings/access-tokens).
+
+#### Interactive Login
+
+The simplest way to authenticate:
+
+```bash
+mux login
+```
+
+You'll be prompted to enter your Mux Token ID and Token Secret. The CLI will validate your credentials before saving them.
+
+#### Login with .env File
+
+If you have your credentials in a `.env` file:
+
+```bash
+mux login --env-file .env
+```
+
+Your `.env` file should contain:
+
+```bash
+MUX_TOKEN_ID=your_token_id
+MUX_TOKEN_SECRET=your_token_secret
+```
+
+#### Named Environments
+
+You can manage multiple environments (e.g., production, staging, development):
+
+```bash
+# Add a production environment
+mux login --name production
+
+# Add a staging environment
+mux login --name staging
+```
+
+The first environment you add becomes the default. You can switch between environments later.
+
+## Commands
+
+### Asset Management
+
+#### `mux assets create`
+
+Create a new Mux video asset from a URL, local file, or JSON configuration.
+
+**Options:**
+- `--url <url>` - Video URL to ingest from the web
+- `--upload <path>` - Local file(s) to upload (supports glob patterns like `*.mp4` or `videos/**/*.mp4`)
+- `--file, -f <path>` - JSON configuration file for complex asset creation
+- `--playback-policy <policy>` - Playback policy: `public` or `signed` (can be specified multiple times)
+- `--test` - Create test asset (watermarked, 10s limit, deleted after 24h)
+- `--passthrough <string>` - User metadata (max 255 characters)
+- `--static-renditions <resolution>` - Static rendition resolutions: `highest`, `audio-only`, `2160p`, `1440p`, `1080p`, `720p`, `540p`, `480p`, `360p`, `270p` (can be specified multiple times)
+- `--video-quality <quality>` - Video quality level: `basic`, `plus`, or `premium`
+- `--normalize-audio` - Normalize audio loudness level
+- `-y, --yes` - Skip confirmation prompts
+- `--json` - Output JSON instead of pretty format
+- `--wait` - Wait for asset processing to complete (polls until ready)
+
+**Examples:**
+
+```bash
+# Create asset from remote URL
+mux assets create --url https://example.com/video.mp4 --playback-policy public
+
+# Upload a single local file
+mux assets create --upload video.mp4 --playback-policy public --test
+
+# Upload multiple files with glob pattern
+mux assets create --upload ./videos/*.mp4 --playback-policy public
+# Shows confirmation prompt with file list and total size
+
+# Skip confirmation for multiple files
+mux assets create --upload ./videos/*.mp4 --playback-policy public -y
+
+# Create asset with complex configuration from JSON file
+mux assets create --file asset-config.json
+
+# Override config file options with flags
+mux assets create --file asset-config.json --test --playback-policy signed
+
+# Wait for asset to be ready
+mux assets create --url https://example.com/video.mp4 --playback-policy public --wait
+
+# Get JSON output for scripting
+mux assets create --url https://example.com/video.mp4 --playback-policy public --json
+```
+
+**JSON Configuration File:**
+
+For complex asset creation (overlays, subtitles, multiple input tracks), use a JSON configuration file:
+
+```json
+{
+  "input": [
+    {
+      "url": "https://example.com/video.mp4",
+      "overlay_settings": {
+        "url": "https://example.com/logo.png",
+        "vertical_align": "bottom",
+        "horizontal_align": "right",
+        "vertical_margin": "5%",
+        "horizontal_margin": "5%",
+        "opacity": "80%"
+      },
+      "generated_subtitles": [
+        {
+          "language_code": "en",
+          "name": "English"
+        }
+      ]
+    }
+  ],
+  "playback_policies": ["signed"],
+  "video_quality": "plus",
+  "static_renditions": [{ "resolution": "1080p" }],
+  "normalize_audio": true,
+  "passthrough": "my-video-123"
+}
+```
+
+Then create the asset:
+
+```bash
+mux assets create --file asset-config.json
+```
+
+**Multiple File Uploads:**
+
+When using glob patterns, each file creates a separate asset:
+
+```bash
+mux assets create --upload ./videos/*.mp4 --playback-policy public
+# Creates 3 separate assets if 3 files match
+
+# Output:
+# Found 3 files to upload:
+#   - intro.mp4 (45.2 MB)
+#   - main.mp4 (128.7 MB)
+#   - outro.mp4 (23.1 MB)
+# Total size: 197.1 MB
+# Continue with upload? (y/n):
+```
+
+#### `mux assets list`
+
+List all video assets with pagination and filtering options.
+
+**Options:**
+- `--limit <number>` - Number of results to return (default: 25)
+- `--page <number>` - Page number for pagination (default: 1)
+- `--upload-id <id>` - Filter assets by upload ID
+- `--live-stream-id <id>` - Filter assets by live stream ID
+- `--json` - Output JSON instead of pretty format
+- `--compact` - Output one line per asset in grep-friendly format
+
+**Examples:**
+
+```bash
+# List assets with default settings (25 assets, page 1)
+mux assets list
+
+# List first 10 assets
+mux assets list --limit 10
+
+# List second page of results
+mux assets list --page 2
+
+# Filter by upload ID
+mux assets list --upload-id abc123xyz
+
+# Get JSON output for scripting
+mux assets list --json
+
+# Get compact output for grep and parsing
+mux assets list --compact
+```
+
+**Output (default pretty format):**
+
+```
+Found 3 asset(s):
+
+sRkgb02SMJOjf72PFIkegcrZR3knHPEPG  ready  0:09  07/25 14:16
+  Details:
+    ├─ Aspect Ratio: 240:427
+    ├─ Resolution: 720p
+    └─ Quality: plus
+  Meta:
+    └─ Title: golf-swing
+  Playback IDs:
+    ├─ 🔓 rFHdcXSf95EHT32qYnf6ZnBz01D7VyKR4
+    └─ 🔒 qo5Y6CpYtdZBgQlI6VskadqdNcQQVdPh
+```
+
+**Output (with --compact flag):**
+
+```
+sRkgb02SMJOjf72PFIkegcrZR3knHPEPG  ready  0:09  07/25 14:16  720p  "golf-swing"  public,signed  -
+```
+
+#### `mux assets get <asset-id>`
+
+Get detailed information about a specific video asset.
+
+**Arguments:**
+- `<asset-id>` - The ID of the asset to retrieve
+
+**Options:**
+- `--json` - Output JSON instead of pretty format
+
+**Examples:**
+
+```bash
+# Get asset details
+mux assets get abc123xyz
+
+# Get asset details as JSON
+mux assets get abc123xyz --json
+```
+
+**Output:**
+
+```
+Asset ID: abc123xyz
+Status: ready
+Duration: 120.45s
+Created: 1234567890
+Aspect Ratio: 16:9
+Resolution Tier: 1080p
+Video Quality: plus
+Max Resolution: HD
+Max Frame Rate: 30.00 fps
+
+Playback IDs:
+  - playback123 (public)
+    URL: https://stream.mux.com/playback123.m3u8
+
+Tracks:
+  - audio: audio_track_id
+    Duration: 120.45s
+  - video: video_track_id
+    Duration: 120.45s
+
+Passthrough: my-video-metadata
+
+WARNING: This is a test asset (will be deleted after 24 hours)
+```
+
+#### `mux assets update <asset-id>`
+
+Update metadata fields on a video asset.
+
+**Arguments:**
+- `<asset-id>` - The ID of the asset to update
+
+**Options:**
+- `--title <string>` - Set `meta.title` (max 512 characters)
+- `--creator-id <string>` - Set `meta.creator_id` (max 128 characters)
+- `--external-id <string>` - Set `meta.external_id` (max 128 characters)
+- `--passthrough <string>` - Set `passthrough` (max 255 characters)
+- `--json` - Output JSON instead of pretty format
+
+At least one field flag must be provided.
+
+**Examples:**
+
+```bash
+# Set a title on an asset
+mux assets update abc123xyz --title "My Video"
+
+# Set multiple fields at once
+mux assets update abc123xyz --title "My Video" --creator-id "user-42" --external-id "vid-001"
+
+# Update passthrough metadata
+mux assets update abc123xyz --passthrough "my-custom-metadata"
+
+# Clear a field by passing an empty string
+mux assets update abc123xyz --title ""
+
+# Get JSON output
+mux assets update abc123xyz --title "My Video" --json
+```
+
+**Output:**
+
+```
+Asset updated successfully.
+
+Asset ID: abc123xyz
+Status: ready
+Duration: 120.45s
 ...
 ```
-<!-- usagestop -->
 
-# Commands
+#### `mux assets delete <asset-id>`
+
+Delete a video asset permanently.
+
+**Arguments:**
+- `<asset-id>` - The ID of the asset to delete
+
+**Options:**
+- `-f, --force` - Skip confirmation prompt
+- `--json` - Output JSON instead of pretty format
+
+**Examples:**
+
+```bash
+# Delete asset with confirmation prompt
+mux assets delete abc123xyz
+
+# Delete asset without confirmation
+mux assets delete abc123xyz --force
+
+# Delete asset with JSON output (requires --force for safety)
+mux assets delete abc123xyz --json --force
+```
+
+**Important:** When using `--json` output mode, you must also provide the `--force` flag. This safety feature prevents accidental deletions in automated scripts.
+
+**Output:**
+
+```
+Are you sure you want to delete asset abc123xyz? (y/n): y
+Asset abc123xyz deleted successfully
+```
+
+#### `mux assets manage`
+
+Interactively manage Mux video assets using a terminal user interface (TUI). This command provides a visual interface to browse assets, view details, manage playback IDs, and copy URLs directly from your terminal.
+
+**Examples:**
+
+```bash
+# Launch the interactive asset management TUI
+mux assets manage
+```
+
+**Features:**
+
+- Browse all video assets with pagination
+- View detailed asset information
+- Create and delete playback IDs
+- Copy stream URLs (HLS) to clipboard
+- Copy player URLs to clipboard
+- Delete assets with confirmation
+- Automatic URL signing for signed playback policies
+
+**Navigation:**
+
+- **Arrow keys** - Navigate through assets and menu options
+- **Enter** - Select an asset or action
+- **q** - Quit or go back to previous view
+- **Escape** - Cancel current operation
+
+**Note:** This command requires an interactive terminal (TTY). For scripting and non-interactive use cases, use `mux assets list`, `mux assets get`, and related commands instead.
+
+#### Playback ID Management
+
+Playback IDs control access to your video assets. Each asset can have multiple playback IDs with different policies (public or signed).
+
+##### `mux assets playback-ids list <asset-id>`
+
+List all playback IDs for a specific asset.
+
+**Arguments:**
+- `<asset-id>` - The ID of the asset
+
+**Options:**
+- `--json` - Output JSON instead of pretty format
+
+**Examples:**
+
+```bash
+# List playback IDs for an asset
+mux assets playback-ids list abc123xyz
+
+# Get JSON output
+mux assets playback-ids list abc123xyz --json
+```
+
+**Output:**
+
+```
+Found 2 playback ID(s) for asset abc123xyz:
+
+Playback ID: playback123
+  Policy: public
+  URL: https://stream.mux.com/playback123.m3u8
+
+Playback ID: playback456
+  Policy: signed
+  URL: https://stream.mux.com/playback456.m3u8
+```
+
+##### `mux assets playback-ids create <asset-id>`
+
+Create a new playback ID for an asset.
+
+**Arguments:**
+- `<asset-id>` - The ID of the asset
+
+**Options:**
+- `--policy <policy>` - Playback policy: `public` or `signed` (default: `public`)
+- `--json` - Output JSON instead of pretty format
+
+**Examples:**
+
+```bash
+# Create a public playback ID
+mux assets playback-ids create abc123xyz
+
+# Create a signed playback ID
+mux assets playback-ids create abc123xyz --policy signed
+
+# Get JSON output
+mux assets playback-ids create abc123xyz --policy public --json
+```
+
+**Output:**
+
+```
+Playback ID created: playback123
+  Policy: public
+  URL: https://stream.mux.com/playback123.m3u8
+```
+
+##### `mux assets playback-ids delete <asset-id> <playback-id>`
+
+Delete a playback ID from an asset.
+
+**Arguments:**
+- `<asset-id>` - The ID of the asset
+- `<playback-id>` - The ID of the playback ID to delete
+
+**Options:**
+- `-f, --force` - Skip confirmation prompt
+- `--json` - Output JSON instead of pretty format
+
+**Examples:**
+
+```bash
+# Delete a playback ID with confirmation
+mux assets playback-ids delete abc123xyz playback123
+
+# Delete without confirmation
+mux assets playback-ids delete abc123xyz playback123 --force
+
+# Delete with JSON output
+mux assets playback-ids delete abc123xyz playback123 --force --json
+```
+
+**Output:**
+
+```
+Are you sure you want to delete playback ID playback123 from asset abc123xyz? (y/n): y
+Playback ID playback123 deleted successfully
+```
+
+#### Static Renditions Management
+
+Static renditions are downloadable MP4 versions of your video assets at specific resolutions. Unlike streaming playback, these are complete files that can be downloaded.
+
+##### `mux assets static-renditions list <asset-id>`
 
-<!-- commands -->
-* [`mux assets:create INPUT`](#mux-assetscreate-input)
-* [`mux assets:upload PATH`](#mux-assetsupload-path)
-* [`mux autocomplete [SHELL]`](#mux-autocomplete-shell)
-* [`mux commands`](#mux-commands)
-* [`mux help [COMMAND]`](#mux-help-command)
-* [`mux init [ENVFILE]`](#mux-init-envfile)
-* [`mux live:complete STREAMNAME`](#mux-livecomplete-streamname)
-* [`mux live:disable STREAMNAME`](#mux-livedisable-streamname)
-* [`mux live:enable STREAMNAME`](#mux-liveenable-streamname)
-* [`mux plugins`](#mux-plugins)
-* [`mux plugins:inspect PLUGIN...`](#mux-pluginsinspect-plugin)
-* [`mux plugins:install PLUGIN...`](#mux-pluginsinstall-plugin)
-* [`mux plugins:link PLUGIN`](#mux-pluginslink-plugin)
-* [`mux plugins:uninstall PLUGIN...`](#mux-pluginsuninstall-plugin)
-* [`mux plugins:update`](#mux-pluginsupdate)
-* [`mux sign PLAYBACK-ID`](#mux-sign-playback-id)
-* [`mux update [CHANNEL]`](#mux-update-channel)
+List all static renditions for a specific asset.
 
-## `mux assets:create INPUT`
+**Arguments:**
+- `<asset-id>` - The ID of the asset
 
-Create a new asset in Mux using a file that's already available online
+**Options:**
+- `--json` - Output JSON instead of pretty format
 
+**Examples:**
+
+```bash
+# List static renditions for an asset
+mux assets static-renditions list abc123xyz
+
+# Get JSON output
+mux assets static-renditions list abc123xyz --json
 ```
-USAGE
-  $ mux assets:create INPUT
 
-ARGUMENTS
-  INPUT  input URL for the file you'd like to create this asset from
+**Output:**
+
+```
+Static renditions for asset abc123xyz:
 
-OPTIONS
-  -p, --private  add a private playback policy to the created asset
+  1080p.mp4        [ready]      1920x1080    5.2 Mbps   42.3 MB
+    ID: rendition123
+  720p.mp4         [preparing]  1280x720     -          -
+    ID: rendition456
 ```
 
-_See code: [src/commands/assets/create.ts](https://github.com/muxinc/cli/blob/v0.7.1/src/commands/assets/create.ts)_
+##### `mux assets static-renditions create <asset-id>`
+
+Create a new static rendition for an asset.
+
+**Arguments:**
+- `<asset-id>` - The ID of the asset
 
-## `mux assets:upload PATH`
+**Options:**
+- `-r, --resolution <resolution>` - Target resolution (required): `highest`, `audio-only`, `2160p`, `1440p`, `1080p`, `720p`, `540p`, `480p`, `360p`, `270p`
+- `-p, --passthrough <string>` - Custom metadata for the rendition (max 255 characters)
+- `-w, --wait` - Wait for the rendition to be ready instead of returning immediately
+- `--json` - Output JSON instead of pretty format
 
-Create a new asset in Mux via a local file
+**Examples:**
 
+```bash
+# Create a 1080p rendition
+mux assets static-renditions create abc123xyz --resolution 1080p
+
+# Create and wait for completion
+mux assets static-renditions create abc123xyz --resolution 720p --wait
+
+# Create with custom metadata
+mux assets static-renditions create abc123xyz --resolution 1080p --passthrough "web-download"
+
+# Get JSON output
+mux assets static-renditions create abc123xyz --resolution 1080p --json
 ```
-USAGE
-  $ mux assets:upload PATH
 
-ARGUMENTS
-  PATH  local path for the file (or folder) you'd like to upload
+**Output:**
+
+```
+Static rendition created:
+  ID: rendition123
+  Name: 1080p.mp4
+  Resolution: 1080p
+  Status: preparing
 
-OPTIONS
-  -c, --concurrent=concurrent  [default: 3] max number of files to upload at once
-  -f, --filter=filter          regex that filters the selected destination if the provided path is a folder
-  -p, --private
+Note: Static rendition generation is asynchronous. Use 'mux assets static-renditions list <asset-id>' to check the status, or use the --wait flag to poll until ready.
 ```
 
-_See code: [src/commands/assets/upload.ts](https://github.com/muxinc/cli/blob/v0.7.1/src/commands/assets/upload.ts)_
+##### `mux assets static-renditions delete <asset-id> <rendition-id>`
 
-## `mux autocomplete [SHELL]`
+Delete a static rendition from an asset.
 
-display autocomplete installation instructions
+**Arguments:**
+- `<asset-id>` - The ID of the asset
+- `<rendition-id>` - The ID of the rendition to delete
 
+**Options:**
+- `-f, --force` - Skip confirmation prompt
+- `--json` - Output JSON instead of pretty format
+
+**Examples:**
+
+```bash
+# Delete a static rendition with confirmation
+mux assets static-renditions delete abc123xyz rendition123
+
+# Delete without confirmation
+mux assets static-renditions delete abc123xyz rendition123 --force
+
+# Delete with JSON output
+mux assets static-renditions delete abc123xyz rendition123 --force --json
 ```
-USAGE
-  $ mux autocomplete [SHELL]
 
-ARGUMENTS
-  SHELL  shell type
+**Output:**
+
+```
+Are you sure you want to delete static rendition rendition123? (y/n): y
+Static rendition rendition123 deleted from asset abc123xyz
+```
+
+### Live Stream Management
+
+#### `mux live create`
+
+Create a new Mux live stream for broadcasting.
+
+**Options:**
+- `--playback-policy <policy>` - Playback policy: `public` or `signed` (can be specified multiple times)
+- `--new-asset-settings <settings>` - Automatically create an asset from this live stream. Use `none` to disable, or provide a JSON string with asset settings (e.g., `'{"playback_policies": ["public"]}'`)
+- `--reconnect-window <seconds>` - Time in seconds a stream can be disconnected before being considered finished (default: 60)
+- `--latency-mode <mode>` - Latency mode: `low`, `reduced`, or `standard` (default: `low`)
+- `--test` - Create test live stream (deleted after 24h)
+- `--json` - Output JSON instead of pretty format
 
-OPTIONS
-  -r, --refresh-cache  Refresh cache (ignores displaying instructions)
+**Examples:**
+
+```bash
+# Create a basic live stream with public playback
+mux live create --playback-policy public
+
+# Create a low-latency live stream
+mux live create --playback-policy public --latency-mode low
+
+# Create a stream that automatically saves to an asset
+mux live create --playback-policy public --new-asset-settings '{"playback_policies": ["public"]}'
+
+# Create a test stream (deleted after 24 hours)
+mux live create --playback-policy public --test
+
+# Create with extended reconnect window (5 minutes)
+mux live create --playback-policy public --reconnect-window 300
+
+# Get JSON output for scripting
+mux live create --playback-policy public --json
+```
+
+**Output:**
+
+```
+Live stream created: abc123xyz
+  Status: idle
+  Stream Key: your-secret-stream-key
+  Playback URL: https://stream.mux.com/playback123.m3u8
 
-EXAMPLES
-  $ mux autocomplete
-  $ mux autocomplete bash
-  $ mux autocomplete zsh
-  $ mux autocomplete --refresh-cache
+WARNING: This is a test stream (will be deleted after 24 hours)
 ```
 
-_See code: [@oclif/plugin-autocomplete](https://github.com/oclif/plugin-autocomplete/blob/v1.1.1/src/commands/autocomplete/index.ts)_
+**Using the Stream:**
 
-## `mux commands`
+Once created, you can stream to your live stream using the RTMP URL and stream key:
+- **RTMP URL:** `rtmp://global-live.mux.com/app`
+- **Stream Key:** The `stream_key` returned in the response
 
-list all the commands
+Configure your streaming software (OBS, Wirecast, etc.) with these values to start broadcasting.
 
+#### `mux live list`
+
+List all live streams with pagination.
+
+**Options:**
+- `--limit <number>` - Number of results to return (default: 25)
+- `--page <number>` - Page number for pagination (default: 1)
+- `--json` - Output JSON instead of pretty format
+- `--compact` - Output one line per stream in grep-friendly format
+
+**Examples:**
+
+```bash
+# List live streams with default settings
+mux live list
+
+# List first 10 streams
+mux live list --limit 10
+
+# List second page of results
+mux live list --page 2
+
+# Get JSON output for scripting
+mux live list --json
+
+# Get compact output for grep and parsing
+mux live list --compact
 ```
-USAGE
-  $ mux commands
 
-OPTIONS
-  -h, --help              Show CLI help.
-  -x, --extended          show extra columns
-  --columns=columns       only show provided columns (comma-separated)
-  --csv                   output is csv format [alias: --output=csv]
-  --filter=filter         filter property by partial string matching, ex: name=foo
-  --hidden                show hidden commands
-  --json                  Format output as json.
-  --no-header             hide table header from output
-  --no-truncate           do not truncate output to fit screen
-  --output=csv|json|yaml  output in a more machine friendly format
-  --sort=sort             property to sort by (prepend '-' for descending)
+**Output (default pretty format):**
+
+```
+Found 2 live stream(s):
+
+waWxn5KIZCYmILAOWgXW9dFBPnOXq00JM  idle  08/18 16:43
+  Details:
+    ├─ Stream Key: c3eb...1724
+    ├─ Latency Mode: standard
+    ├─ Reconnect Window: 60s
+    └─ Max Duration: 12h
+  Recent Assets:
+    └─ 00QNOSkxzBdlASP3iIvTfvqxDN3u74hUX
+  Playback IDs:
+    └─ 🔒 EIyqm8p4VwGj5sO9rNBtykFbbKFFSNWA
 ```
 
-_See code: [@oclif/plugin-commands](https://github.com/oclif/plugin-commands/blob/v2.0.2/src/commands/commands.ts)_
+**Output (with --compact flag):**
 
-## `mux help [COMMAND]`
+```
+waWxn5KIZCYmILAOWgXW9dFBPnOXq00JM  idle  08/18 16:43  standard  60s  signed  1 assets
+```
+
+#### `mux live get <stream-id>`
+
+Get detailed information about a specific live stream.
+
+**Arguments:**
+- `<stream-id>` - The ID of the live stream to retrieve
+
+**Options:**
+- `--json` - Output JSON instead of pretty format
 
-Display help for mux.
+**Examples:**
 
+```bash
+# Get live stream details
+mux live get abc123xyz
+
+# Get live stream details as JSON
+mux live get abc123xyz --json
 ```
-USAGE
-  $ mux help [COMMAND]
 
-ARGUMENTS
-  COMMAND  Command to show help for.
+**Output:**
 
-OPTIONS
-  -n, --nested-commands  Include all nested commands in the output.
 ```
+Live Stream ID: abc123xyz
+Status: active
+Created: 1234567890
+Stream Key: your-secret-stream-key
+Latency Mode: low
+Reconnect Window: 60s
+
+Playback IDs:
+  - playback123 (public)
+    URL: https://stream.mux.com/playback123.m3u8
+
+New Asset Settings:
+  Playback Policy: public
+  Recording enabled: Yes
+
+WARNING: This is a test stream (will be deleted after 24 hours)
+```
+
+#### `mux live delete <stream-id>`
+
+Delete a live stream permanently.
+
+**Arguments:**
+- `<stream-id>` - The ID of the live stream to delete
 
-_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v5.1.10/src/commands/help.ts)_
+**Options:**
+- `-f, --force` - Skip confirmation prompt
+- `--json` - Output JSON instead of pretty format
 
-## `mux init [ENVFILE]`
+**Examples:**
 
-set up a user-level config
+```bash
+# Delete stream with confirmation prompt
+mux live delete abc123xyz
 
+# Delete stream without confirmation
+mux live delete abc123xyz --force
+
+# Delete stream with JSON output (requires --force for safety)
+mux live delete abc123xyz --json --force
 ```
-USAGE
-  $ mux init [ENVFILE]
 
-ARGUMENTS
-  ENVFILE  path to a Mux access token .env file
+**Important:** When using `--json` output mode, you must also provide the `--force` flag. This safety feature prevents accidental deletions in automated scripts.
+
+**Output:**
 
-OPTIONS
-  -f, --force  Will initialize a new file even if one already exists.
 ```
+Are you sure you want to delete live stream abc123xyz? (y/n): y
+Live stream abc123xyz deleted successfully
+```
+
+#### Playback ID Management
+
+Manage playback IDs for live streams. Each live stream can have multiple playback IDs with different policies (public or signed).
+
+##### `mux live playback-ids list <stream-id>`
 
-_See code: [src/commands/init.ts](https://github.com/muxinc/cli/blob/v0.7.1/src/commands/init.ts)_
+List all playback IDs for a specific live stream.
 
-## `mux live:complete STREAMNAME`
+**Arguments:**
+- `<stream-id>` - The ID of the live stream
+
+**Options:**
+- `--json` - Output JSON instead of pretty format
+
+**Examples:**
+
+```bash
+# List playback IDs for a live stream
+mux live playback-ids list abc123xyz
+
+# Get JSON output
+mux live playback-ids list abc123xyz --json
+```
 
-Signal to Mux that a live stream has concluded and should be closed.
+**Output:**
 
 ```
-USAGE
-  $ mux live:complete STREAMNAME
+Found 2 playback ID(s) for live stream abc123xyz:
 
-ARGUMENTS
-  STREAMNAME  the name (coupled with --reference-type) to look up in Mux to yield this livestream
+Playback ID: playback123
+  Policy: public
+  URL: https://stream.mux.com/playback123.m3u8
 
-OPTIONS
-  -d, --disableAfterCompletion  If set, disables the stream upon completion.
-  -t, --streamId=stream-id      [default: stream-id] the type of the provided reference name
+Playback ID: playback456
+  Policy: signed
+  URL: https://stream.mux.com/playback456.m3u8
 ```
 
-_See code: [src/commands/live/complete.ts](https://github.com/muxinc/cli/blob/v0.7.1/src/commands/live/complete.ts)_
+##### `mux live playback-ids create <stream-id>`
 
-## `mux live:disable STREAMNAME`
+Create a new playback ID for a live stream.
 
-Disables a live stream and prevents encoders from streaming to it.
+**Arguments:**
+- `<stream-id>` - The ID of the live stream
 
+**Options:**
+- `--policy <policy>` - Playback policy: `public` or `signed` (default: `public`)
+- `--json` - Output JSON instead of pretty format
+
+**Examples:**
+
+```bash
+# Create a public playback ID
+mux live playback-ids create abc123xyz
+
+# Create a signed playback ID
+mux live playback-ids create abc123xyz --policy signed
+
+# Get JSON output
+mux live playback-ids create abc123xyz --policy public --json
 ```
-USAGE
-  $ mux live:disable STREAMNAME
 
-ARGUMENTS
-  STREAMNAME  the name (coupled with --reference-type) to look up in Mux to yield this livestream
+**Output:**
 
-OPTIONS
-  -t, --streamId=stream-id  [default: stream-id] the type of the provided reference name
+```
+Playback ID created: playback123
+  Policy: public
+  URL: https://stream.mux.com/playback123.m3u8
 ```
 
-_See code: [src/commands/live/disable.ts](https://github.com/muxinc/cli/blob/v0.7.1/src/commands/live/disable.ts)_
+##### `mux live playback-ids delete <stream-id> <playback-id>`
 
-## `mux live:enable STREAMNAME`
+Delete a playback ID from a live stream.
 
-Enables a live stream, allowing encoders to streaming to it.
+**Arguments:**
+- `<stream-id>` - The ID of the live stream
+- `<playback-id>` - The ID of the playback ID to delete
 
+**Options:**
+- `-f, --force` - Skip confirmation prompt
+- `--json` - Output JSON instead of pretty format
+
+**Examples:**
+
+```bash
+# Delete a playback ID with confirmation
+mux live playback-ids delete abc123xyz playback123
+
+# Delete without confirmation
+mux live playback-ids delete abc123xyz playback123 --force
+
+# Delete with JSON output
+mux live playback-ids delete abc123xyz playback123 --force --json
 ```
-USAGE
-  $ mux live:enable STREAMNAME
 
-ARGUMENTS
-  STREAMNAME  the name (coupled with --reference-type) to look up in Mux to yield this livestream
+**Output:**
 
-OPTIONS
-  -t, --streamId=stream-id  [default: stream-id] the type of the provided reference name
+```
+Are you sure you want to delete playback ID playback123 from live stream abc123xyz? (y/n): y
+Playback ID playback123 deleted successfully
 ```
 
-_See code: [src/commands/live/enable.ts](https://github.com/muxinc/cli/blob/v0.7.1/src/commands/live/enable.ts)_
+### Playback ID Lookup
 
-## `mux plugins`
+#### `mux playback-ids <playback-id>`
 
-List installed plugins.
+Look up which asset or live stream a playback ID belongs to. This is useful when you have a playback ID and need to find the associated resource.
 
+**Arguments:**
+- `<playback-id>` - The playback ID to look up
+
+**Options:**
+- `--expand` - Fetch and return the full asset or live stream object instead of just the reference
+- `--json` - Output JSON instead of pretty format
+
+**Examples:**
+
+```bash
+# Look up a playback ID (returns basic info)
+mux playback-ids abc123playbackid
+
+# Look up and fetch the full asset or live stream object
+mux playback-ids abc123playbackid --expand
+
+# Get JSON output
+mux playback-ids abc123playbackid --json
+```
+
+**Output (basic lookup):**
+
+```
+Playback ID: abc123playbackid
+Policy: public
+Type: asset
+ID: abc123xyz
+```
+
+**Output (with --expand):**
+
+When using `--expand`, the output will be the full asset or live stream object, formatted the same as `mux assets get` or `mux live get` commands.
+
+**Note:** The nested `playback-ids` commands under `assets` and `live` (e.g., `mux assets playback-ids list`) are for managing playback IDs on known resources. This top-level command is for discovering what resource a playback ID belongs to.
+
+### Signing Keys & Secure Playback
+
+#### `mux signing-keys create`
+
+Create a new signing key for secure video playback and automatically save it to the current environment.
+
+**Options:**
+- `--json` - Output JSON instead of pretty format
+
+**Examples:**
+
+```bash
+# Create a new signing key
+mux signing-keys create
+
+# Create a signing key with JSON output
+mux signing-keys create --json
+```
+
+**Output:**
+
+```
+Signing key created and saved to environment: default
+Key ID: qrdSB18tYITC7GNQCFJWKr25M9JPkMxJ
 ```
-USAGE
-  $ mux plugins
 
-OPTIONS
-  --core  Show core plugins.
+**Important:** The private key is only returned once during creation. The CLI automatically stores it in your current environment configuration, so you don't need to manually save it.
+
+#### `mux signing-keys list`
+
+List all signing keys with indicators showing which keys are configured in local environments.
+
+**Options:**
+- `--json` - Output JSON instead of pretty format
 
-EXAMPLE
-  $ mux plugins
+**Examples:**
+
+```bash
+# List all signing keys
+mux signing-keys list
+
+# List signing keys with JSON output
+mux signing-keys list --json
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v2.0.12/src/commands/plugins/index.ts)_
+**Output:**
 
-## `mux plugins:inspect PLUGIN...`
+```
+Found 2 signing key(s):
 
-Displays installation properties of a plugin.
+Key ID: qrdSB18tYITC7GNQCFJWKr25M9JPkMxJ
+  Created: 1234567890
+  Active in environments: production, staging
+
+Key ID: abc123def456ghi789jkl012mno345pq
+  Created: 1234567891
+  Active in environments: development
+```
 
+#### `mux signing-keys get <key-id>`
+
+Get detailed information about a specific signing key.
+
+**Arguments:**
+- `<key-id>` - The ID of the signing key to retrieve
+
+**Options:**
+- `--json` - Output JSON instead of pretty format
+
+**Examples:**
+
+```bash
+# Get signing key details
+mux signing-keys get qrdSB18tYITC7GNQCFJWKr25M9JPkMxJ
+
+# Get signing key details as JSON
+mux signing-keys get qrdSB18tYITC7GNQCFJWKr25M9JPkMxJ --json
+```
+
+**Output:**
+
+```
+Signing Key ID: qrdSB18tYITC7GNQCFJWKr25M9JPkMxJ
+Created: 1234567890
+Active in environments: production
 ```
-USAGE
-  $ mux plugins:inspect PLUGIN...
 
-ARGUMENTS
-  PLUGIN  [default: .] Plugin to inspect.
+#### `mux signing-keys delete <key-id>`
 
-OPTIONS
-  -h, --help     Show CLI help.
-  -v, --verbose
+Delete a signing key permanently. This will invalidate all signed URLs created with this key.
 
-EXAMPLE
-  $ mux plugins:inspect myplugin
+**Arguments:**
+- `<key-id>` - The ID of the signing key to delete
+
+**Options:**
+- `-f, --force` - Skip confirmation prompt
+- `--json` - Output JSON instead of pretty format
+
+**Examples:**
+
+```bash
+# Delete signing key with confirmation prompt
+mux signing-keys delete qrdSB18tYITC7GNQCFJWKr25M9JPkMxJ
+
+# Delete signing key without confirmation
+mux signing-keys delete qrdSB18tYITC7GNQCFJWKr25M9JPkMxJ --force
+
+# Delete signing key with JSON output
+mux signing-keys delete qrdSB18tYITC7GNQCFJWKr25M9JPkMxJ --force --json
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v2.0.12/src/commands/plugins/inspect.ts)_
+**Important:** Deleting a signing key will invalidate all tokens and signed URLs created with that key. If the key is configured in any local environment, it will be automatically removed from those environment configurations.
 
-## `mux plugins:install PLUGIN...`
+**Output:**
 
-Installs a plugin into the CLI.
+```
+WARNING: This signing key is configured in the following environments: production
 
+Deleting this key will invalidate all signed URLs created with it.
+Are you sure you want to delete signing key qrdSB18tYITC7GNQCFJWKr25M9JPkMxJ? (y/n): y
+
+Signing key qrdSB18tYITC7GNQCFJWKr25M9JPkMxJ deleted successfully
+Removed from environment: production
 ```
-USAGE
-  $ mux plugins:install PLUGIN...
 
-ARGUMENTS
-  PLUGIN  Plugin to install.
+#### `mux sign <playback-id>`
+
+Sign a playback ID to generate a secure URL for video playback, thumbnails, GIFs, or storyboards. This is used with assets or live streams that have a `signed` playback policy.
+
+**Arguments:**
+- `<playback-id>` - The playback ID to sign
+
+**Options:**
+- `-e, --expiration <duration>` - Token expiration duration (default: '7d')
+  - Examples: '7d', '24h', '1h', '30m'
+- `-t, --type <type>` - Token type: `video`, `thumbnail`, `gif`, `storyboard` (default: 'video')
+- `-p, --param <key=value>` - JWT claim as key=value (repeatable). Used to embed parameters like `time`, `width`, or `height` directly in the signed token.
+- `--params-json <json>` - JWT claims as a JSON object. Useful for complex claims including nested values like `custom`.
+- `--json` - Output JSON instead of pretty format
+- `--token-only` - Output only the JWT token (no URL)
+
+When `--param` and `--params-json` are both provided, `--params-json` is applied first as a base layer and `--param` values override on top.
 
-OPTIONS
-  -f, --force    Run yarn install with force flag.
-  -h, --help     Show CLI help.
-  -v, --verbose
+**Examples:**
 
-DESCRIPTION
-  Can be installed from npm or a git url.
+```bash
+# Sign a playback ID with default settings (7 day expiration, video type)
+mux sign abc123playbackid
 
-  Installation of a user-installed plugin will override a core plugin.
+# Sign with custom expiration
+mux sign abc123playbackid --expiration 24h
 
-  e.g. If you have a core plugin that has a 'hello' command, installing a user-installed plugin with a 'hello' command 
-  will override the core plugin implementation. This is useful if a user needs to update core plugin functionality in 
-  the CLI without the need to patch and update the whole CLI.
+# Sign for thumbnail access at a specific time
+mux sign abc123playbackid --type thumbnail --param time=14
 
-ALIASES
-  $ mux plugins:add
+# Sign for thumbnail with dimensions
+mux sign abc123playbackid --type thumbnail --param time=14 --param width=100
 
-EXAMPLES
-  $ mux plugins:install myplugin 
-  $ mux plugins:install https://github.com/someuser/someplugin
-  $ mux plugins:install someuser/someplugin
+# Sign for animated GIF
+mux sign abc123playbackid --type gif
+
+# Sign with custom claims for tracking (nested under "custom" in JWT)
+mux sign abc123playbackid --params-json '{"custom": {"session_id": "xxxx-123"}}'
+
+# Get JSON output with full details
+mux sign abc123playbackid --json
+
+# Get only the JWT token for scripting
+mux sign abc123playbackid --token-only
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v2.0.12/src/commands/plugins/install.ts)_
+**Output:**
+
+The output URL uses the appropriate domain based on the token type:
+
+```bash
+# Video (default) - uses stream.mux.com
+mux sign abc123playbackid
+https://stream.mux.com/abc123playbackid.m3u8?token=eyJ...
 
-## `mux plugins:link PLUGIN`
+# Thumbnail - uses image.mux.com
+mux sign abc123playbackid --type thumbnail --param time=14
+https://image.mux.com/abc123playbackid/thumbnail.png?token=eyJ...
 
-Links a plugin into the CLI for development.
+# GIF - uses image.mux.com
+mux sign abc123playbackid --type gif
+https://image.mux.com/abc123playbackid/animated.gif?token=eyJ...
 
+# Storyboard - uses image.mux.com
+mux sign abc123playbackid --type storyboard
+https://image.mux.com/abc123playbackid/storyboard.vtt?token=eyJ...
 ```
-USAGE
-  $ mux plugins:link PLUGIN
 
-ARGUMENTS
-  PATH  [default: .] path to plugin
+**Thumbnail Parameters:**
 
-OPTIONS
-  -h, --help     Show CLI help.
-  -v, --verbose
+When signing thumbnails, parameters like `time` and `width` must be embedded in the JWT claims (not as query parameters). The `--param` flag handles this automatically:
 
-DESCRIPTION
-  Installation of a linked plugin will override a user-installed or core plugin.
+| Parameter | Description |
+|-----------|-------------|
+| `time` | Video timestamp in seconds for the thumbnail |
+| `width` | Thumbnail width in pixels |
+| `height` | Thumbnail height in pixels |
+| `rotate` | Rotate clockwise: 90, 180, or 270 |
+| `fit_mode` | How to fit: `preserve`, `stretch`, `crop`, `smartcrop`, `pad` |
+| `flip_v` | Flip vertically |
+| `flip_h` | Flip horizontally |
 
-  e.g. If you have a user-installed or core plugin that has a 'hello' command, installing a linked plugin with a 'hello'
-   command will override the user-installed or core plugin implementation. This is useful for development work.
+**Prerequisites:**
 
-EXAMPLE
-  $ mux plugins:link myplugin
+Before using `mux sign`, you must have a signing key configured in your current environment:
+
+```bash
+# Create and configure a signing key
+mux signing-keys create
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v2.0.12/src/commands/plugins/link.ts)_
+If no signing keys are configured, the command will provide helpful instructions on how to set one up.
+
+### Authentication & Environment Management
+
+#### `mux login`
+
+Authenticate with Mux and save credentials.
+
+**Options:**
+- `-f, --env-file <path>` - Path to .env file containing credentials
+- `-n, --name <name>` - Name for this environment (default: "default")
 
-## `mux plugins:uninstall PLUGIN...`
+**Examples:**
 
-Removes a plugin from the CLI.
+```bash
+# Interactive login
+mux login
 
+# Login with .env file
+mux login --env-file .env
+
+# Login with a named environment
+mux login --name production --env-file .env.production
 ```
-USAGE
-  $ mux plugins:uninstall PLUGIN...
 
-ARGUMENTS
-  PLUGIN  plugin to uninstall
+#### `mux logout <name>`
+
+Remove credentials for a specific environment.
+
+**Arguments:**
+- `<name>` - Name of the environment to remove
 
-OPTIONS
-  -h, --help     Show CLI help.
-  -v, --verbose
+**Examples:**
 
-ALIASES
-  $ mux plugins:unlink
-  $ mux plugins:remove
+```bash
+# Remove the default environment
+mux logout default
+
+# Remove a named environment
+mux logout staging
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v2.0.12/src/commands/plugins/uninstall.ts)_
+When you remove the default environment, the CLI automatically selects another environment as the new default.
+
+#### `mux env list`
 
-## `mux plugins:update`
+Display all configured environments.
 
-Update installed plugins.
+**Examples:**
 
+```bash
+mux env list
 ```
-USAGE
-  $ mux plugins:update
 
-OPTIONS
-  -h, --help     Show CLI help.
-  -v, --verbose
+**Output:**
 ```
+Configured environments:
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v2.0.12/src/commands/plugins/update.ts)_
+* production (default)
+  staging
+  development
 
-## `mux sign PLAYBACK-ID`
+3 environments total
+```
 
-Creates a new signed URL token for a playback ID
+#### `mux env switch <name>`
+
+Change the default environment.
+
+**Arguments:**
+- `<name>` - Name of the environment to set as default
+
+**Examples:**
+
+```bash
+# Switch to staging environment
+mux env switch staging
+```
 
+## Configuration
+
+Credentials are stored securely in `~/.config/mux/config.json` with restrictive file permissions (readable/writable only by the owner).
+
+The configuration file structure:
+
+```json
+{
+  "environments": {
+    "production": {
+      "tokenId": "your_token_id",
+      "tokenSecret": "your_token_secret"
+    },
+    "staging": {
+      "tokenId": "your_staging_token_id",
+      "tokenSecret": "your_staging_token_secret"
+    }
+  },
+  "defaultEnvironment": "production"
+}
 ```
-USAGE
-  $ mux sign PLAYBACK-ID
 
-ARGUMENTS
-  PLAYBACK-ID  Playback ID to create a signed URL token for.
+## Development
 
-OPTIONS
-  -e, --expiresIn=expiresIn                  [default: 7d] How long the signature is valid for. If no unit is specified,
-                                             milliseconds is assumed.
+This project uses [Bun](https://bun.sh) as the JavaScript runtime and is written in TypeScript.
 
-  -t, --type=video|thumbnail|gif|storyboard  [default: video] What type of token this signature is for.
+### Prerequisites
+
+- Bun runtime installed
+- pnpm for package management
+
+### Setup
+
+```bash
+# Install dependencies
+pnpm install
+
+# Run tests
+bun test
+
+# Build the project
+pnpm run build
 ```
 
-_See code: [src/commands/sign.ts](https://github.com/muxinc/cli/blob/v0.7.1/src/commands/sign.ts)_
+### Testing
 
-## `mux update [CHANNEL]`
+The project includes comprehensive test coverage for core functionality:
 
-update the mux CLI
+```bash
+# Run all tests
+bun test
 
+# Run tests in watch mode
+bun test --watch
 ```
-USAGE
-  $ mux update [CHANNEL]
 
-OPTIONS
-  --from-local  interactively choose an already installed version
+### Project Structure
+
+```
+src/
+├── commands/                 # CLI command definitions
+│   ├── assets/              # Asset management commands
+│   │   ├── manage/          # Interactive TUI for asset management
+│   │   │   ├── index.ts     # TUI command entry point
+│   │   │   └── AssetManageApp.tsx  # Main TUI application
+│   │   ├── playback-ids/    # Playback ID commands for assets
+│   │   │   ├── index.ts     # Main playback-ids command
+│   │   │   ├── create.ts    # Create playback IDs
+│   │   │   ├── list.ts      # List playback IDs
+│   │   │   └── delete.ts    # Delete playback IDs
+│   │   ├── index.ts         # Main assets command
+│   │   ├── create.ts        # Create assets
+│   │   ├── list.ts          # List assets
+│   │   ├── get.ts           # Get asset details
+│   │   ├── update.ts        # Update asset metadata
+│   │   └── delete.ts        # Delete assets
+│   ├── live/                # Live stream management commands
+│   │   ├── playback-ids/    # Playback ID commands for live streams
+│   │   │   ├── index.ts     # Main playback-ids command
+│   │   │   ├── create.ts    # Create playback IDs
+│   │   │   ├── list.ts      # List playback IDs
+│   │   │   └── delete.ts    # Delete playback IDs
+│   │   ├── index.ts         # Main live command
+│   │   ├── create.ts        # Create live streams
+│   │   ├── list.ts          # List live streams
+│   │   ├── get.ts           # Get live stream details
+│   │   └── delete.ts        # Delete live streams
+│   ├── signing-keys/        # Signing key management commands
+│   │   ├── index.ts         # Main signing-keys command
+│   │   ├── create.ts        # Create signing keys
+│   │   ├── list.ts          # List signing keys
+│   │   ├── get.ts           # Get signing key details
+│   │   └── delete.ts        # Delete signing keys
+│   ├── env/                 # Environment management commands
+│   │   ├── index.ts         # Main env command
+│   │   ├── list.ts          # List environments
+│   │   └── switch.ts        # Switch default environment
+│   ├── login.ts             # Login command
+│   ├── logout.ts            # Logout command
+│   └── sign.ts              # Sign playback IDs command
+├── lib/                     # Shared libraries
+│   ├── tui/                 # Reusable TUI components
+│   │   ├── index.ts         # TUI exports
+│   │   ├── renderer.tsx     # OpenTUI renderer setup
+│   │   ├── SelectList.tsx   # Reusable selection list component
+│   │   ├── ActionMenu.tsx   # Reusable action menu component
+│   │   ├── ConfirmDialog.tsx # Reusable confirmation dialog
+│   │   └── clipboard.ts     # Clipboard utilities
+│   ├── config.ts            # Configuration management
+│   ├── formatters.ts        # Shared output formatting (timestamps, durations, statuses)
+│   ├── mux.ts               # Mux API integration and auth helpers
+│   ├── json-config.ts       # JSON configuration parsing
+│   ├── file-upload.ts       # File upload utilities
+│   ├── urls.ts              # URL generation (stream, player, thumbnail, gif, storyboard)
+│   ├── signing.ts           # JWT signing utilities
+│   ├── playback-ids.ts      # Playback ID operations
+│   └── xdg.ts               # XDG base directory support
+└── index.ts                 # CLI entry point
 ```
 
-_See code: [@oclif/plugin-update](https://github.com/oclif/plugin-update/blob/v2.1.5/src/commands/update.ts)_
-<!-- commandsstop -->
+## License
+
+Apache-2.0. See [LICENSE](LICENSE) for details.
+
+## Support
+
+For issues and questions:
+- File an issue on GitHub
+- Visit [Mux Documentation](https://docs.mux.com/)
+- Contact Mux Support