docs(setup): document persistent SSH lifecycle support

[Microck]

the configuration reference said SSH setup was limited to on-demand token handoff. that contradicted the implemented persistent setup contract and the host onboarding guide.

this corrects the reference to include persistent user-scoped login-session services on macOS and Windows, then links to the existing lifecycle guide.

validation: checked against .facts and docs/how-to/setup-host.mdx; documentation CI will validate the page. runtime, package versions and signed release artifacts are unchanged.

Summary by CodeRabbit

• Documentation
  • Updated setup guidance to clarify that SSH supports both on-demand connections and persistent login sessions on macOS and Windows.
  • Added a reference to Host setup for choosing a lifecycle and viewing the setup plan.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
satelle	Ready	Preview	Oct 5, 2026 5:45pm UTC

[coderabbitai]

Navigate logical layers of code changes, visualize relationships, and explore their blast radius.

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

• Configuration used: Repository: Microck/satelle/.coderabbit.yaml
• Review profile: CHILL
• Plan: Advanced
• Run ID: 9c97ad7f-f47a-4c10-8874-5d171d9aee8d

📥 Commits

Reviewing files that changed from the base of the PR and between 4252ada and 0cef0f3.

📒 Files selected for processing (1)

• docs/reference/configuration.mdx

Included review availability: This review used your included allowance. Your plan provides up to 1 included review per hour; 0 remain after this review.

---

📝 Walkthrough

Walkthrough

The setup overview now describes on-demand SSH setup and persistent user-scoped login-session services on macOS and Windows. It links to Host setup for lifecycle selection and the setup plan.

Changes

SSH setup documentation

Layer / File(s)	Summary
Update SSH setup overview docs/reference/configuration.mdx	The overview now describes on-demand and persistent SSH setup modes and links to Host setup for lifecycle selection and the setup plan.

Priority: ⬇️ Low

Estimated code review effort: 1 (Trivial) | ~3 minutes

Change: Other

Merge Risk: ⚪ Minimal · up to 0cef0

The overview clarifies SSH setup modes and links to matching platform guidance. No actionable merge risk remains.

Architecture Summary

Architecture risk: 🔵 Low · up to 0cef0

The change affects 1 system.

Changed systems: docs

Architecture concerns
No architecture-level concerns identified.

Review details

Systems and components

• observed — docs (service) was modified; 1 changed file maps to changed impact.

Before / after behavior

• observed — Modified behavior in docs/reference/configuration.mdx: The setup overview replaces the claim that SSH supports only on-demand transport token handoff with support for on-demand mode and persistent user-scoped login-session services on macOS and Windows, and links to Host setup for lifecycle selection and the setup plan.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly describes the main change: documenting persistent SSH lifecycle support.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Commit to this branch
• Create a new PR

• Autopilot · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[Microck]

Note

🤖 Codex responding on behalf of Microck

@coderabbitai review

[coderabbitai]

⚠️ Action not completed

Review rate limited.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

[Microck]

Note

🤖 Codex responding on behalf of Microck

@coderabbitai review

[coderabbitai]

✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.