Quickstart Guide
Get Started with Trak in 2 Minutes
Follow these quick steps to install the CLI and materialize your first structured engineering workspace.
1
Install the Trak CLI
Choose your operating system and run the single automated installer one-liner:
$irm https://raw.githubusercontent.com/ndk123-web/trak/main/scripts/install.ps1 | iex
Tip: The installer places trak into your PATH so you can call it anywhere.
2
Verify the Installation
Verify that Trak is installed properly by checking its version information:
$trak version
Tip: You should see the version card (v2.0.0) with Go runtime and platform specs.
3
Explore the Learning Catalog
Browse the 19 available learning blueprints across 5 categories in a tree layout:
$trak list
Tip: You can also filter by category: 'trak list lang' or 'trak list os'.
4
Initialize Your First Learning Workspace
Materialize an official or community learning lab on your local disk:
$trak init lang/go --path ./learn-go
Tip: Supports official tracks (lang/go), community tracks (alice/db/postgres), and pinned versions (alice/db/postgres@v2.0.0).
5
Open and Start Learning Hands-On
Navigate into the workspace and open it in VS Code, GoLand, or Neovim:
$cd ./learn-go && code .
Tip: Read README.md and start completing code exercises in Module 00!
6
Verify Exercises & Sync Progress
Execute native automated unit tests on language tracks or inspect workspace metrics:
$trak verify 00 && trak status
Tip: Full folder names are never required: type 'trak verify 00', 'trak verify 00-', or 'trak verify 1' using shorthand prefixes. Use 'trak next' to find what to study next, and 'trak done <module>' for architectural labs.
7
Launch Trak Studio Visual IDE (v2.0.0 Feature)
Prefer a visual browser workspace? Spin up the embedded web dashboard and Monaco code editor:
$trak studio
Tip: Opens http://localhost:8200 directly in your browser with an interactive curriculum roadmap, visual test runner, and workspaces hub with zero dependencies.
Ready to explore specific technologies?
Browse the full curriculum index with all 19 tracks across Go, Rust, Python, Docker, and Linux.