Skip to content

Document SSH key ownership and privileged authentication for agents - #22

Open
iapyeh wants to merge 2 commits into
releasefrom
docs/ssh-key-ownership-20261010
Open

iapyeh wants to merge 2 commits into
releasefrom
docs/ssh-key-ownership-20261010

Conversation

@iapyeh

@iapyeh iapyeh commented Oct 10, 2026

Copy link
Copy Markdown
Owner

SSH key paths can refer to different hosts and retain the original SSH login permissions even inside sudo/su. Document the calling Session’s ownership of pkey_path, console connection boundaries, and how to load an authorized privileged key into Paramiko before calling connect(pkey=...). Add Python and .spy examples to the API and agent guides and present the agent guide and setup prompts in README.

Validation: four executable documentation tests pass in both the source and staged release layouts; manual Python and .spy key examples pass syntax checks; skill validation, website links and generated download synchronization pass. The privileged examples require real authorized endpoints and are explicitly separate from credential-free examples. No package version, tag, or PyPI release is changed.

This branch also inherits the existing SSH stderr-drain test scheduling fix from PR #21 (db3c991), already present in the source and release checkout. Full required CI remains enabled for the complete PR diff. Unrelated local AI_GUIDE.md changes are excluded.

This branch has not been deployed

No deployments
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.

1 participant