check-env

name	check-env
description	Verifies required tools (Quarto, uv, Python, R, Stata, TeX) and Jupyter kernels are installed. Use when setting up or troubleshooting.
allowed-tools	Bash, Read, Glob, Grep

Check Environment

Verify that all required tools and dependencies are installed and correctly configured.

Steps

1. Check each required tool and report its version (or "not found"):

   Tool	Command	Minimum
   Quarto	quarto --version	>= 1.4
   uv	uv --version	any
   Python	python3 --version	>= 3.12
   R	R --version	optional
   Stata	which stata	optional
   TeX Live	pdflatex --version	optional (for PDF)
   GitHub CLI	gh --version	optional

2. Check Jupyter kernels by running uv run jupyter kernelspec list and verify:

   • python3 — required
   • ir — optional (needed for R notebooks)
   • nbstata — optional (needed for Stata notebooks)

3. Check the Python virtual environment:

   • Verify .venv/ exists
   • Run uv run python -c "import numpy; import pandas; import matplotlib; import jupytext; print('Core packages OK')" to confirm importability

4. Check nbstata configuration (if nbstata kernel is present):

   • Verify ~/.config/nbstata/nbstata.conf exists
   • Read it and check that stata_dir points to an existing directory

5. Report a structured results table:

   Tool/Check              Status    Version/Details
   ─────────────────────────────────────────────────
   Quarto                  PASS      1.6.x
   uv                      PASS      0.x.x
   Python                  PASS      3.12.x
   R                       PASS      4.x.x
   Stata                   SKIP      not found (optional)
   TeX Live                PASS      2024
   GitHub CLI              PASS      2.x.x
   Kernel: python3         PASS      installed
   Kernel: ir              PASS      installed
   Kernel: nbstata         SKIP      not installed
   .venv/                  PASS      exists
   Core Python packages    PASS      importable
   nbstata.conf            SKIP      kernel not installed
   

   Use PASS / FAIL / SKIP (SKIP for optional tools that are absent).

6. If any required check fails, provide the installation command or link to fix it.