lift catalog

Browse, search, and inspect available tools and stacks from the OneLift registry.

lift catalog

Browse the OneLift tool and stack registry. List all available tools and stacks, search by name or category, view detailed manifests, and manage the local cache.

Requires LIFT_API_URL environment variable to be set (automatically configured after lift init).

Subcommands

lift catalog

List all available tools and stacks from the registry.

# List everything
lift catalog

Output shows tool name, version, category, and description alongside available stacks with their tool count.

Search tools and stacks by name, category, or description.

# Search by category
lift catalog search database

# Search by name
lift catalog search redis

# Search by keyword
lift catalog search monitoring

lift catalog info

Show detailed information about a specific tool or stack. For tools, displays the full YAML manifest including variables, compose definition, scripts, and outputs. For stacks, shows the tool list and required tier.

# Tool details (full manifest)
lift catalog info n8n

# Stack details (tool list + tier)
lift catalog info monitoring

lift catalog update

Clear the local cache and force a fresh fetch from the registry on next use.

lift catalog update

Cache

Fetched tool manifests are cached locally at ~/Library/Caches/lift/tools/ (macOS) or ~/.cache/lift/tools/ (Linux). Cache files are stored as <name>@<version>.yaml and are version-aware -- a new tool version automatically bypasses stale cache entries.

Use lift catalog update to manually clear the cache if needed.