CLI Commands/list

trak list

Visualizes all available learning tracks in a clean ASCII tree graph with colored tags, module counts, and version numbers.

$ trak list [category] [flags]

Command Overview

Allows developers to discover tracks directly from the command line without opening a browser. Supports filtering by category name (e.g. 'trak list os') or passing flags.

Execution Lifecycle

Downloads master catalog manifest: registry.json from GitHub

Filters categories based on arguments and flags

Draws formatted Unicode tree graph with branches (├──, └──, │)

Displays colored category icons (📦, 🐧, ☁️, 🗄️, 🛠️) and track descriptions

Outputs interactive tips for initializing discovered tracks

Available Flags

-c, --categoryType: string • Default: all

Filter catalog by specific category (lang, os, cloud, db, tool).

-a, --allType: boolean • Default: false

Display the entire catalog tree with all branches.

-h, --helpType: boolean • Default: false

Show list command help and usage examples.

Usage Examples

List Full Catalog Tree

$trak list

Renders all 19 tracks organized under their 5 parent categories.

Filter by Category Positional Argument

$trak list lang

Shows only programming language tracks (Go, Rust, Python, TS, etc.).

Filter by Category Flag

$trak list -c db

Shows only database tracks (PostgreSQL, Redis, SQL).