docs(install): automatic PATH setup + Intel-Mac fix (#89)#91
Merged
Conversation
…89) netclaw#1687 (shipped in 0.25.0) makes the installers manage PATH automatically. Verified against the 0.25.0 installer source and the running install on this machine (`. ~/.netclaw/env` moves netclaw onto PATH in a fresh shell; the RC file sources it). - installation.md: new "PATH and shell integration" section — Unix env file + RC sourcing (bash/zsh/fish), Windows User PATH, the current-terminal boundary (open a new shell or `. ~/.netclaw/env`; Windows restart), and the --skip-shell / -SkipShell opt-out. Links netclaw#1687 as the source. - quickstart.md: install step now loads netclaw before `netclaw init`, so the install-to-init sequence works in one terminal. - index.astro: per-OS install notes carry the terminal-refresh expectation; corrected the macOS note — Apple Silicon only, Intel Macs are not supported (the installer errors on Intel). Closes #89.
Aaronontheweb
added a commit
that referenced
this pull request
Jul 18, 2026
…laim (#82) (#92) The docs-version guard flagged src/version.json (0.24.3) as behind the latest release. 0.25.0 is now stable with the model/webhook/install surfaces already documented (#90, #91), and 0.25.0 ships no breaking changes. - src/version.json: documentedVersion 0.24.3 -> 0.25.0, lastProfiled -> 2026-07-18 - security/hardening.md: the shell-mode table listed SandboxOnly as one of "three modes", but it has no backend and just denies shell. Demoted to two working modes (Off, HostAllowed) plus a note that setting SandboxOnly yields `shell_requires_sandbox_backend` — so the error stays debuggable without advertising a dead option as a real choice. Behavior re-verified against 0.25.0 (ToolAccessPolicy.cs still returns Deny). Content pass: all other version references are correct historical notes ("Since 0.24.3...", "As of 0.22.1...") and were left as-is. drift check passes. Closes #82.
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.
What
Syncs the website with netclaw#1687 (automatic PATH setup), shipped in 0.25.0, and fixes a wrong macOS architecture claim on the homepage.
Closes #89.
Changes
installation.md— new PATH and shell integration section: the Unix env file (~/.netclaw/env) sourced from.bashrc/.zshrc/fishconf.d, Windows User-PATH prepend, the current-terminal boundary (open a new shell or. ~/.netclaw/env; on Windows, restart), and the--skip-shell/-SkipShellopt-out. The Linux and Windows install notes now point at it, and the Intel-Mac exclusion is stated.quickstart.md— the install step loadsnetclaw(. ~/.netclaw/env) beforenetclaw init, so the sequence works in the terminal you installed from.index.astro— each OS install note carries the terminal-refresh expectation; the macOS note is corrected from "Apple Silicon and Intel Macs" to Apple Silicon only (the installer hard-errors on Intel).Verification
Every claim checked against the 0.25.0 installer source (
scripts/install.sh,scripts/install.ps1) and the running install on a 0.25.0 machine:~/.netclaw/envcontent matches what the docs describe. ~/.netclaw/envin a PATH-less shell resolvesnetclaw(not on PATH→~/.netclaw/bin/netclaw). '~/.netclaw/env'install.shis an explicitError: Intel Macs are not supportedBuild note
Astro compiles all pages (homepage included). The
pagefindsearch-index post-step can't fetch its binary in this sandbox (environmental, reproduces on a clean tree); it doesn't gate content.