Skip to content

docs(hermes): add xAI OAuth auth guide for K8s and ECS#828

Merged
thepagent merged 1 commit into
mainfrom
docs/hermes-auth-guide
May 16, 2026
Merged

docs(hermes): add xAI OAuth auth guide for K8s and ECS#828
thepagent merged 1 commit into
mainfrom
docs/hermes-auth-guide

Conversation

@chaodu-agent
Copy link
Copy Markdown
Collaborator

Summary

Add detailed xAI OAuth authentication instructions for Hermes Agent, covering both Kubernetes (port-forward) and ECS Fargate (curl-the-callback) workflows.

Changes

  • Option A (K8s): port-forward + browser redirect flow
  • Option B (ECS): two exec sessions, curl the callback URL with code + state
  • File ownership fix: chown -R agent:agent after exec-based auth/config commands (exec runs as root, hermes-acp runs as agent)
  • SuperGrok warning: auth succeeds without subscription but API returns empty responses

Context

Discovered during testing on ECS Fargate Spot — the OAuth flow is tricky because:

  1. ECS has no port-forward equivalent
  2. Auth codes expire in seconds
  3. state parameter must match the current session
  4. Files created by exec (root) are unreadable by the agent user

@chaodu-agent chaodu-agent requested a review from thepagent as a code owner May 16, 2026 11:44
@github-actions github-actions Bot added closing-soon PR missing Discord Discussion URL — will auto-close in 3 days pending-screening PR awaiting automated screening labels May 16, 2026
@github-actions
Copy link
Copy Markdown

⚠️ This PR is missing a Discord Discussion URL in the body.

All PRs must reference a prior Discord discussion to ensure community alignment before implementation.

Please edit the PR description to include a link like:

Discord Discussion URL: https://discord.com/channels/...

This PR will be automatically closed in 3 days if the link is not added.

- Option A: K8s port-forward flow
- Option B: ECS curl-the-callback flow (step-by-step)
- File ownership fix after exec-based auth (chown)
- SuperGrok subscription requirement warning
@pahud pahud force-pushed the docs/hermes-auth-guide branch from a857ca1 to 06c3d42 Compare May 16, 2026 11:45
@thepagent thepagent merged commit dfd9960 into main May 16, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

closing-soon PR missing Discord Discussion URL — will auto-close in 3 days pending-screening PR awaiting automated screening

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants