Skip to content

Retire custom install/uninstall scripts; make UV the supported path - #3

Merged
alfdav merged 2 commits into
mainfrom
cursor/uv-install-path-bc34
Aug 15, 2026
Merged

alfdav merged 2 commits into
mainfrom
cursor/uv-install-path-bc34

Conversation

@alfdav

@alfdav alfdav commented Aug 15, 2026

Copy link
Copy Markdown
Owner

Summary

Stop maintaining install.sh, install.ps1, uninstall.sh, and uninstall.ps1. TempFox is installed and removed with UV.

Supported path

uv tool install tempfox
uv tool uninstall tempfox

From source

uv sync
uv run tempfox

pip install tempfox remains a one-line alternative. No second package-manager story and no replacement installer.

What the scripts did vs what remains

The four scripts were Hitmonlee-style wrappers that:

  • Checked Python 3.8+
  • Installed Go and CloudFox if missing
  • Installed UV if missing
  • Created a local venv (~/.local/share/tempfox / %LOCALAPPDATA%\tempfox) and a PATH wrapper
  • Wrote PATH entries into shell rc / Windows user PATH
  • Uninstalled that venv, wrapper, and PATH lines

Moved to UV

  • Package install/uninstall and putting tempfox on PATH (uv tool install / uv tool uninstall)
  • Dev/from-source runs (uv sync / uv run tempfox)

Already covered by runtime preflight (tempfox/dependencies.py)

  • AWS CLI install (the scripts never did this)
  • Go install
  • CloudFox install
  • Session PATH updates for those tools during a TempFox run

Documented loss (not replaced)

  • Persistent shell/user PATH writes for Go, CloudFox, and UV. README and MIGRATION.md now say preflight PATH is for the current TempFox process only.
  • One-shot install-time Go/CloudFox/UV setup before first tempfox run (first run preflight still does Go/CloudFox/AWS CLI)
  • Cleanup of leftover script-era venvs. Docs tell users to delete ~/.local/share/tempfox (Unix) or %LOCALAPPDATA%\tempfox (Windows) before uv tool install, and not to rm ~/.local/bin/tempfox while a UV install is active (that path is the UV shim).

uv.lock

Not added. .gitignore already ignores uv.lock, CI runs uv sync (not --frozen), and Docker copies pyproject.toml only. Pinning a lockfile would invent a new workflow.

Test plan

  • make hygiene-fast baseline on main (55 passed)
  • Contract tests fail while scripts/docs still describe curl|sh / iwr installers
  • After the change, tests/test_install_docs.py passes (scripts gone, UV commands present, no script invocations, leftover cleanup before install, session-only PATH documented)
  • make hygiene on this branch after review fixes: ruff, format, mypy, 60 passed, coverage 58.21% (>= 35), repo-scan clean
  • Makefile / Docker / CI already use UV and never called the deleted scripts
  • No remaining user-facing curl of install.sh / install.ps1

Files changed

  • Deleted: install.sh, install.ps1, uninstall.sh, uninstall.ps1
  • Docs: README.md, MIGRATION.md, docs/project-context.md, MISTAKES.md
  • Tests: tests/test_install_docs.py

Do not merge. This is a separate objective from recon-fixes.

Open in Web Open in Cursor 

…ly path.

Remove install.sh, install.ps1, uninstall.sh, and uninstall.ps1. Users install
and remove TempFox with uv tool install/uninstall (or uv sync / uv run from
source). Runtime preflight still installs AWS CLI, Go, and CloudFox. Docs and
a contract test lock the UV-first story.

Co-authored-by: David Diaz <alfdav@users.noreply.github.com>
@alfdav
alfdav marked this pull request as ready for review August 15, 2026 23:33

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved. Cursor Bugbot was not present after the initial check poll, so that signal was skipped; remaining policy and review-state checks did not require human review. No reviewers were assigned.

Open in Web View Automation 

Sent by Cursor Approval Agent: Pull Request Router and Approver

State that Go/CloudFox PATH is no longer persisted to the shell. Tell
users to remove the script-era venv before uv tool install so they do
not delete the UV shim. Tighten the install-path contract tests.

Co-authored-by: David Diaz <alfdav@users.noreply.github.com>
@alfdav
alfdav merged commit e9d2854 into main Aug 15, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants