Skip to content

join should hint or auto-attempt relay lookup for hosted invites #7

Description

@kn8-codes

Envoy 0.2.4 (git_commit bbedb403a9363f012e186a4f9e0d76d321cf4628, build 2026-05-16T15:39:44Z) produced a confusing cross-machine join failure for a hosted invite.

Environment

  • Inviter: macOS, Envoy CLI 0.2.4
  • Joiner: Linux host, Envoy CLI 0.2.4-era client
  • Space: private shared space name redacted

Observed

A standard invite with --max-uses 1 appeared local-only. A reusable invite with --max-uses 0 was reported as relay/hosted capable:

connected_relay
hosted_redeemable
remote_redeemable

On the remote machine, joining without an explicit relay flag failed:

local invite not found
relay_lookup_attempted: false

The exact same invite worked with:

envoy join --allow-relay-lookup --name 'Janine HP' --agent <redacted-invite-code>

Expected

For a hosted/redeemable invite, either:

  1. envoy join automatically attempts relay lookup when local lookup fails, or
  2. the error says something like: Invite not found locally. This may be a hosted invite; retry with --allow-relay-lookup.

Impact

The current failure mode makes a valid hosted invite look invalid or local-only, which slows down cross-machine recovery.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions