[krishhgg]

Give users one line to paste into their coding agent:

Set up sys1rust on my Mac from https://github.com/krishhgg/sys1rust

Add AGENTS.md, a Claude entry point and setup, use and develop skills in .agents/skills, with Claude skill symlinks pointing to the same files. The setup guide handles fresh Macs without Git tools, Rosetta, PATH shadowing, chosen ports in clone and piped installs and manual updates, manual or login startup, updates, uninstall and installer lock recovery. Manual setup selects loopback and typed-decisions explicitly and isolates inherited API keys and revisions to match its verification request. The API guide distinguishes request model aliases from CLI model selection, covers actual request validation and guarantees subprocess cleanup. The development guide stops tests at the first failure and distinguishes bit identity from the existing 0.001 tolerance checks.

This PR builds on the installer PR and adds the agent prompt to its README. Merge the installer first.

Validation:

• All 20 shell and Python examples and 2 JSON examples in the skills and AGENTS.md parse; relative links and Claude skill symlinks resolve.

• Controlled Git and tar download paths enter the scratch checkout; failures leave the working directory unchanged.

• Commands and request fields match the final installer, CLI and validation code. Test claims match settings.rs.

• The installer passed 117 checks under both shells; its real service lifecycle, documented candidate check and 120-question smoke test passed.

• The documented manual setup, verification request and Python subprocess example passed against the real bundle with conflicting host, model, API key and revision settings. All servers stopped cleanly. Seven live model-field cases matched the guide.

• Downloaded fixture scripts through curl confirmed the native and arm64 no-clone service commands preserve port 8001 under sh and dash. The previous pipeline reproduced the port loss.

• The update commands preserved manual port 8001 with no LaunchAgent and used recorded service port 8002 under both sh and dash.

Confidence Score: 5/5

This PR appears safe to merge; the update instructions now preserve the manually chosen port.

What we checked:

• Updates keep the right port: The guide keeps the manually chosen PORT. For a running service, both the guide and installer read its saved LAYA_PORT.

Summary

Adds agent guides for installing, calling and developing sys1rust, with shared Claude skill links and a setup prompt in the README.

• The latest change separates SERVICE_PORT from the manually chosen PORT.
• The previous port-loss finding is fixed. No new actionable issues were found.

_{Reviews (4) · Last reviewed commit: "Keep the manually chosen port when updat..." · Reviewed by Greptile}