Docs/help: claude + all runtimes, fresh-clone → install gotcha#10
Merged
Conversation
…install gotcha Self-service install/update readiness audit. The scripts already work standalone — verified a fresh install (all files, runtime=all, 0 placeholder leaks), an update (reads runtime from the manifest), and clear errors for an invalid runtime and a missing manifest. The only gaps were stale help/docs that hadn't caught up to Claude Code being a runtime: - bin/install.sh + bin/update.sh -h: runtime list now cursor|zed|claude|both|all (was cursor|zed|both); added all/claude examples; widened the sed ranges to print the new lines. - update.sh -h now states it reads the runtime from the manifest, and the fresh-clone gotcha. - QUICKSTART + README: all/claude install examples, Claude Code in the runtime row + after-install restart step, and a callout that a FRESH CLONE must `install` (the manifest is gitignored, so `update` stops with "Not installed. Run install first."). Docs/help only — no code change. 62/62 tests. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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
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.
Readiness audit so the install/update scripts are fully self-service.
Verified working standalone (temp-repo test): fresh
install --runtime all --no-setup(all key files,runtime=all, 0__GITNEXUS_REPO__leaks);update(reads runtime from manifest); clear errors —Invalid runtime "bogus". Use any of: …andNot installed … Run install first.Fixed the doc/help staleness (Claude Code wasn't represented):
bin/install.sh/bin/update.sh-h: runtime listcursor|zed|claude|both|all(wascursor|zed|both) +all/claudeexamples.update.sh -h: notes it reads runtime from the manifest + the fresh-clone gotcha.all/claudeexamples, Claude Code in the runtime + after-install rows, and a callout that a fresh clone mustinstall(manifest is gitignored →updatesays "Not installed").Docs/help only, no code change. 62/62 tests.
🤖 Generated with Claude Code