Cursor commands & version-prep scripts

Quick reference for slash commands in ~/.cursor/commands and Python tooling in version-prep/scripts, with copy-paste examples where they help.

Commands folder /Users/llatin/.cursor/commands Scripts folder /Users/llatin/.cursor/version-prep/scripts

Cursor slash commands

Type / in Cursor chat and pick a command, or reference the name below.

/deep link

Confluence or spec deltas → tappable HTML + PDF for iOS/Android deep link testing. Output under ~/.cursor/version-prep/Deep links testing/.

Regenerate artifacts 
python3 /Users/llatin/.cursor/version-prep/scripts/render_deep_links_testing.py

/demo-pr

Interactive demo package: Slack MD, HTML, PDF under ~/.cursor/Demo/<feature>/ using git diff + generate_html.py demo.

Generate demo HTML 
python3 ~/.cursor/version-prep/scripts/generate_html.py demo \
  ~/.cursor/Demo/my-feature/demo_data.json \
  ~/.cursor/Demo/my-feature/DEMO_my-feature.html

/explain-pr

PR summary with highlights and explain-pr HTML/PDF; JSON in ~/.cursor/presentations/, themes: warm / minimal / dark.

Generate HTML 
python3 ~/.cursor/version-prep/scripts/generate_html.py explain-pr \
  ~/.cursor/presentations/PR_PRESENTATION_my-branch_data.json \
  ~/.cursor/presentations/PR_PRESENTATION_my-branch.html

/html features

Interactive QA Features Summary (screenshots, version folder under ~/.cursor/version-prep/[VERSION]/).

Generate summary HTML 
python3 ~/.cursor/version-prep/scripts/generate_html.py features \
  ~/.cursor/version-prep/3.14.0/features_data.json \
  ~/.cursor/version-prep/3.14.0/QA_Features_Summary_3.14.0.html

/html-pr

Standalone PR presentation HTML/PDF from branch data JSON.

Generate presentation 
python3 ~/.cursor/version-prep/scripts/generate_html.py pr-presentation \
  ~/.cursor/presentations/PR_PRESENTATION_my-branch_data.json \
  ~/.cursor/presentations/PR_PRESENTATION_my-branch.html

/html URL

Regenerate GitHub Pages index (A–Z by <title>), commit, push for https://llatin10.github.io/.

Sync index & deploy 
python3 "/Users/llatin/.cursor/HTML URL/sync_index.py"
cd "/Users/llatin/.cursor/HTML URL" && git add -A && git status

/manual-tests

Manual test docs (Markdown and/or TTM) from PR diff or Jira; outputs under ~/.cursor/manual flows/{FEATURE_FOLDER}/.

Git context (excerpt) 
BASE_BRANCH=$(python3 ~/.cursor/version-prep/scripts/git_utils.py detect-base-branch)
python3 ~/.cursor/version-prep/scripts/git_utils.py fetch-base-branch "$BASE_BRANCH"
DIFF=$(python3 ~/.cursor/version-prep/scripts/git_utils.py get-diff "$BASE_BRANCH")

/OnDemand specific test run

Build the workflow line for run-specific-tests.yml: comma-separated *ClassName list plus verification table.

Example paste line 
*DepositChequeTest,*ToggleBiometricTest,*QuickLogInBlockedAfter5TimesTest

/fix-element

Trace Appium “can’t locate element” to Compose testTags; workspace mobile-tests, read-only android-banking.

Find usages of an ID 
grep -r "button_continue" src/

/run a test

Run one test on a physical Android device via project script (Appium, self-heal).

From mobile-tests repo root 
python3 scripts/run_test_on_device.py "DailySavingsCreateNewDailySavingWithAll2RulesTurnedOn"

/pr-review

Full PR review with platform criteria (iOS / Android / TS / Java / CI); uses git_utils.py for diff; optional linter_utils.py run for auto-fix.

Fetch diff 
BASE_BRANCH=$(python3 ~/.cursor/version-prep/scripts/git_utils.py detect-base-branch)
python3 ~/.cursor/version-prep/scripts/git_utils.py fetch-base-branch "$BASE_BRANCH"
python3 ~/.cursor/version-prep/scripts/git_utils.py get-diff "$BASE_BRANCH"

/pr-description

Markdown PR description from full diff; saved as PR_DESCRIPTION_TEMP.md via file_utils.py.

Write temp file 
python3 ~/.cursor/version-prep/scripts/file_utils.py create PR_DESCRIPTION_TEMP.md "$CONTENT" "$(pwd)"

/slack-pr

Slack announcement from diff; Unicode emojis; file under ~/.cursor/Slack messages/SLACK_<branch>.md.

/quick-commit

No prompts: detect linter, linter_utils.py run, auto message, commit, push.

/commit-small · /commit-major

Conventional commits: one-liner vs multi-paragraph with body/footer (feat/fix/docs…).

/integration-tests

Summary of new/changed tests in PR → integration_tests_summary.md.

/debug-day

Strip assertions, add logging (Kotlin Timber, Swift print/OZLogger, etc.) for full-flow diagnosis.

/pull-all

git fetch --all --prune, report behind/gone branches, confirm before fast-forward or delete.

/colleague-pr

Apply fixes for review comments and draft copy-paste replies.

version-prep Python scripts

All scripts live in /Users/llatin/.cursor/version-prep/scripts. Utilities are imported by the main tools.

Script Role Example
create_qa_features.py Interactive QA Features Summary HTML workflow. Usually driven via /html features; pairs with generate_html.py features.
generate_html.py HTML from JSON or Markdown: modes features, pr-presentation, explain-pr, demo, markdown. Themes: warm, minimal, dark (features also classic). python3 generate_html.py markdown path/to/doc.md path/to/out.html (needs pip install markdown)
features_summary_themes.py CSS themes for QA Features Summary. —
document_templates_themes.py CSS for pr-presentation, explain-pr, demo. —
generate_pdf.py HTML → PDF (Playwright Chromium recommended). python3 generate_pdf.py input.html output.pdf
render_deep_links_testing.py Build deeplink HTML + PDF from deeplinks-data.json in Deep links testing folder. python3 render_deep_links_testing.py
git_utils.py Branch/diff helpers: detect-base-branch, fetch-base-branch, get-diff, get-diff-stat, get-current-branch, get-project-type. python3 git_utils.py detect-base-branch
file_utils.py Create/delete files from shell-friendly args (used by PR description, Slack path, etc.). python3 file_utils.py create NAME.md "content" "/path/to/dir"
linter_utils.py Detect and run project linter (detect, run). python3 linter_utils.py run

GitHub Pages site folder

Published HTML for llatin10.github.io lives at /Users/llatin/.cursor/HTML URL. After adding pages, run sync_index.py (as in /html URL) so the home page lists every *.html by title.