Skip to main content

tly list

Overview

The tly list command displays all your deployments with their current status and details.

Usage

tly list

Output

The command displays a table with:

  • ID - Deployment identifier
  • Name - Project name
  • Status - Current state (Running, Stopped, Building)
  • URL - Deployment URL
  • Created - When it was deployed

Example output:

┌─────────────┬──────────────┬─────────┬───────────────────────────────────┬────────────┐
│ ID │ Name │ Status │ URL │ Created │
├─────────────┼──────────────┼─────────┼───────────────────────────────────┼────────────┤
│ abc123def │ mcp-weather │ Running │ https://abc123.prod.targetly.io │ 2 days ago │
│ xyz789ghi │ mcp-search │ Stopped │ https://xyz789.prod.targetly.io │ 1 week ago │
│ qwe456rty │ mcp-database │ Running │ https://qwe456.prod.targetly.io │ 3 hours ago│
└─────────────┴──────────────┴─────────┴───────────────────────────────────┴────────────┘

3 total deployments (2 running, 1 stopped)

Status Types

StatusDescriptionActions Available
RunningContainer is activeStop, View logs
StoppedContainer is sleepingStart, View logs
BuildingImage is being builtWait, View logs
FailedDeployment failedRedeploy

Use Cases

  • Quick Overview See all deployments at a glance

  • Find Deployment IDs Get IDs for other commands

  • Monitor Status Check which deployments are active

  • Resource Management Identify stopped deployments to clean up

Filtering (Future)

Future versions will support filtering:

# Show only running deployments
tly list --status running

# Show deployments from last week
tly list --since 7d
  • tly start Wake stopped deployments

  • tly stop Stop running deployments

  • tly logs View deployment logs