CLI Commands/status

trak status

Inspects the current workspace for trak.json, calculates module completion metrics, and renders a visual progress dashboard.

$ trak status

Command Overview

Scans the current working directory for trak.json manifest. Displays track metadata, formatted creation date, ASCII progress bar with exact completion percentages, and a status checklist of all curriculum modules.

Execution Lifecycle

Workspace Discovery — Searches current directory for trak.json manifest

State Deserialization — Parses module_breakdown completion map

Progress Calculation — Computes completed vs total modules and percentage

Dashboard Output — Renders track info, ASCII progress bar, and module breakdown

Next Step Guidance — Suggests the next pending module to work on

Available Flags

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

Show status command help.

Usage Examples

Inspect Workspace Progress

$trak status

Displays visual progress dashboard and status of all modules in current workspace.

Important Technical Guidelines

Workspace Root Context

Run 'trak status' from within your initialized track folder (or any of its subdirectories) where trak.json resides.

Frequently Asked Questions (FAQ)

Q:Where is my progress stored?

Your progress is saved locally inside trak.json in your workspace root folder.