hermes-agent/website/docs/guides
kshitijk4poor 26a57467a8 fix(cli): harden `hermes portal` SystemExit handling + finish model-pick doc sweep
Self-review of #38465 surfaced three real items:

1. SystemExit escape (defense): `_login_nous` raises SystemExit(130)/(1) on
   cancel/failure. The logged-out login path inside `_model_flow_nous` catches
   it, but the expired-session re-login path (main.py) only catches Exception,
   so a Ctrl-C during re-auth could propagate past `_run_portal_one_shot` and
   kill the CLI. Add SystemExit to the portal handler so all cancel/abort cases
   end with the graceful 'Setup cancelled / retry later' message.

2. Doc sweep: the model-pick step was only added to the bare-`hermes portal`
   prose. Propagate it to the surfaces describing `hermes setup --portal`
   behavior that still omitted model selection:
   - `--portal` argparse help (main.py)
   - nous-portal.md intro + the numbered 'what it does' step list (EN + zh-Hans)
   - run-hermes-with-nous-portal.md 'default model after setup --portal' line,
     which was now contradictory (there's a picker, not a forced default) (EN + zh)

3. Test coverage: add parametrized regression test asserting the portal handler
   swallows KeyboardInterrupt / EOFError / SystemExit (returns None, no escape).

Note on 'Skip (keep current)': delegating to _model_flow_nous means picking
Skip preserves the prior provider instead of force-switching to nous — this is
intentional and matches quick setup exactly; docs now say 'sets Nous as your
provider (when you pick a model)' rather than unconditionally.
2026-06-04 02:33:33 +05:30
..
_category_.json
…
automate-with-cron.md
…
automation-templates.md
…
aws-bedrock.md
…
azure-foundry.md
…
build-a-hermes-plugin.md
…
cron-script-only.md
…
cron-troubleshooting.md
…
daily-briefing-bot.md
…
delegation-patterns.md
…
github-pr-review-agent.md
…
google-gemini.md
…
local-llm-on-mac.md
…
local-ollama-setup.md
…
microsoft-graph-app-registration.md
…
migrate-from-openclaw.md
…
minimax-oauth.md
…
oauth-over-ssh.md
…
operate-teams-meeting-pipeline.md
…
pipe-script-output.md
…
python-library.md
…
run-hermes-with-nous-portal.md
…
team-telegram-assistant.md
…
tips.md
…
use-mcp-with-hermes.md
…
use-soul-with-hermes.md
…
use-voice-mode-with-hermes.md
…
webhook-github-pr-review.md
…
work-with-skills.md
…
xai-grok-oauth.md
…