Add install.cat installer scripts and quick install docs#231
Open
insign wants to merge 5 commits intoavihaymenahem:mainfrom
Open
Add install.cat installer scripts and quick install docs#231insign wants to merge 5 commits intoavihaymenahem:mainfrom
insign wants to merge 5 commits intoavihaymenahem:mainfrom
Conversation
AGENT_PLAN_ANCHOR ## Original User Request (verbatim) Vamos fazer o mesmo neste outro projeto, faça clone, estude a forma de instalação e resolva a issue: avihaymenahem#187 continue ## Objective Add install.cat-compatible root installer scripts and README install guidance for velo, then prepare a fork-based upstream PR and show the PR message for approval before creating it. ## Execution Plan - [ ] Step 1: Add root install.sh and install.ps1 with dynamic latest-release asset selection and platform-specific installation flows. - [ ] Step 2: Update README.md to make install.cat the primary install path while keeping manual downloads as fallback. - [ ] Step 3: Validate the new scripts and docs in this environment. - [ ] Step 4: Commit the implementation, push a fork branch, and draft the PR message for approval. - [ ] Step 5: Create the upstream PR after approval. ## Do - Keep install.sh compatible with sh for install.cat piping. - Use current GitHub release assets dynamically instead of hardcoded version URLs. - Preserve the existing manual install information in README.md. - Stop before creating the PR and show the exact title/body for approval. ## Do Not - Create the PR before approval of the PR message. - Change unrelated application logic or release workflows. - Delete the temp clone before the PR workflow is complete. ## References - avihaymenahem#187 - https://install.cat - README.md - CONTRIBUTING.md - src-tauri/tauri.conf.json - .github/workflows/release.yml - .github/pull_request_template.md ## Risks and Dependencies - Release asset names and supported architectures must be matched dynamically. - macOS and Windows install flows cannot be executed end-to-end from this Linux environment. - The install.cat README command format conflicts with generic URI expectations and may need pragmatic adjustment if reviewers object.
PLAN_REF: 6c5eadf54f52a9d123868c8f2a8338c93a89ca4c PREVIOUS_STEP: 6c5eadf54f52a9d123868c8f2a8338c93a89ca4c — plan initialized ## Completed in This Step - Added a POSIX-compatible root install.sh for install.cat on macOS and Linux - Added a root install.ps1 that installs the latest Windows MSI or setup executable - Used dynamic GitHub release asset selection instead of hardcoded version URLs ## References Used - avihaymenahem#187 - https://install.cat - src-tauri/tauri.conf.json - .github/workflows/release.yml ## Debts and Warnings - PowerShell execution could not run end-to-end from this Linux environment - macOS and Windows install flows were validated statically, not executed here ## Progress (ref: 6c5eadf54f52a9d123868c8f2a8338c93a89ca4c) - [x] Step 1: Add root install.sh and install.ps1 with dynamic latest-release asset selection and platform-specific installation flows. - [ ] Step 2: Update README.md to make install.cat the primary install path while keeping manual downloads as fallback. - [ ] Step 3: Validate the new scripts and docs in this environment. - [ ] Step 4: Commit the implementation, push a fork branch, and draft the PR message for approval. - [ ] Step 5: Create the upstream PR after approval. ## Next Step chore(agent): [Step 2/5] update README install flow
PLAN_REF: 6c5eadf54f52a9d123868c8f2a8338c93a89ca4c PREVIOUS_STEP: 65a5dad415f64af4361c5f1ef41f3ce0c2532a25 — added install.cat installer scripts ## Completed in This Step - Added install.cat quick-install commands to the README installation section - Kept the manual GitHub Releases download link as a fallback path - Documented the platform-specific behavior of the new installers ## References Used - README.md - https://install.cat - .github/pull_request_template.md ## Debts and Warnings - README commands use explicit https for better URI compatibility with common shells and PowerShell ## Progress (ref: 6c5eadf54f52a9d123868c8f2a8338c93a89ca4c) - [x] Step 1: Add root install.sh and install.ps1 with dynamic latest-release asset selection and platform-specific installation flows. - [x] Step 2: Update README.md to make install.cat the primary install path while keeping manual downloads as fallback. - [x] Step 3: Validate the new scripts and docs in this environment. - [ ] Step 4: Commit the implementation, push a fork branch, and draft the PR message for approval. - [ ] Step 5: Create the upstream PR after approval. ## Next Step chore(agent): [Step 4/5] push fork branch and draft PR message
PLAN_REF: 6c5eadf54f52a9d123868c8f2a8338c93a89ca4c ## Completed in This Step - Let install.sh run privileged commands directly when already executed as root - Guarded temp cleanup and surfaced a clearer GitHub rate-limit error message ## References Used - Reviewer report for 65a5dad ## Debts and Warnings - PowerShell execution remains statically validated in this Linux environment ## Progress (ref: 6c5eadf54f52a9d123868c8f2a8338c93a89ca4c) - [x] Step 1: Add root install.sh and install.ps1 with dynamic latest-release asset selection and platform-specific installation flows. - [x] Step 2: Update README.md to make install.cat the primary install path while keeping manual downloads as fallback. - [x] Step 3: Validate the new scripts and docs in this environment. - [x] Step 4: Commit the implementation, push a fork branch, and draft the PR message for approval. - [ ] Step 5: Create the upstream PR after approval. ## Next Step fix: draft PR message and await approval
PLAN_REF: 6c5eadf54f52a9d123868c8f2a8338c93a89ca4c ## Completed in This Step - Restored cleanup order so mounted DMGs are detached before the temp directory is removed ## References Used - Reviewer report for 70ebceb ## Debts and Warnings - PowerShell execution remains statically validated in this Linux environment ## Progress (ref: 6c5eadf54f52a9d123868c8f2a8338c93a89ca4c) - [x] Step 1: Add root install.sh and install.ps1 with dynamic latest-release asset selection and platform-specific installation flows. - [x] Step 2: Update README.md to make install.cat the primary install path while keeping manual downloads as fallback. - [x] Step 3: Validate the new scripts and docs in this environment. - [x] Step 4: Commit the implementation, push a fork branch, and draft the PR message for approval. - [ ] Step 5: Create the upstream PR after approval. ## Next Step fix: draft PR message and await approval
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Add install.cat-compatible installer scripts so Velo can be installed directly from the repo on macOS, Linux, and Windows.
Changes
install.shfor macOS/Linux with latest-release asset detection, universal DMG handling, Debian package installation, and AppImage fallbackinstall.ps1that downloads the latest Windows release and prefers the MSI installer with setup.exe fallbackREADME.mdto make install.cat the primary quick-install path while keeping GitHub Releases as the manual fallbackType of Change
Testing
npm run test)Validation performed:
sh -n install.sh.deb, and AppImagepwshwas not available in this Linux environment, soinstall.ps1was statically reviewed onlyScreenshots
Not applicable.