workspace-course-topics

Workflow: Verify MyST tools are installed

Purpose: Quick checklist to confirm all MyST-related tools are working before starting MyST conversion work.

Time: < 1 minute (if setup_env.sh ran successfully)

Checklist

Run each command and confirm it prints a version number:

1. MyST CLI

myst --version

Expected: A version like v1.6.0 or higher.

If missing: npm install -g mystmd (see Install MyST CLI)

2. Jupytext

jupytext --version

Expected: A version like 1.19.1 or higher.

If missing: pip install jupytext (or re-run bash scripts/setup_env.sh)

3. MyST-Markdown Cursor extension

  1. Open the Extensions panel in Cursor (Cmd+Shift+X / Ctrl+Shift+X).
  2. Search your installed extensions for MyST.
  3. Confirm MyST-Markdown by ExecutableBookProject is installed.

If missing: See Install MyST-Markdown extension

All good?

If all three checks pass, you’re ready to proceed with the MyST Assembly orchestrator.

If any tool is missing, the fastest fix is to re-run the setup script from the ballpark repo root:

cd ~/GitHub/<your-username>/ballpark
bash scripts/setup_env.sh