Skip to content

Accept the documented REARM_URL / REARM_API_ID / REARM_API_KEY env spellings - #36

Merged
taleodor merged 1 commit into
mainfrom
2026-08-env-var-aliases
Aug 2, 2026
Merged

Accept the documented REARM_URL / REARM_API_ID / REARM_API_KEY env spellings#36
taleodor merged 1 commit into
mainfrom
2026-08-env-var-aliases

Conversation

@taleodor-claude

Copy link
Copy Markdown
Contributor

The CLI's env auth binding was derived purely from flag names (uri/apikeyid/apikey), so only REARM_URI/REARM_APIKEYID/REARM_APIKEY worked — while the operator-facing docs (orientation.md §1.1 and the agentic workflow page on the documentation site) tell people to export REARM_URL/REARM_API_ID/REARM_API_KEY. Those were silently unbound: the CLI fell through to empty values and failed with Post "/graphql": unsupported protocol scheme "". Multiple agent sessions independently re-discovered this and worked around it with explicit -u/-i/-k flags.

Fix: explicit BindEnv for the auth trio accepting both spellings. Docs need no changes — they become correct.

Precedence, each case verified empirically against a live instance:

  1. REARM_URL/REARM_API_ID/REARM_API_KEY alone → authenticates (was broken);
  2. REARM_URI/REARM_APIKEYID/REARM_APIKEY alone → still authenticates (no regression);
  3. both spellings set → the flag-derived spelling (REARM_URI et al) wins;
  4. explicit -u flag → still overrides env entirely;
  5. agent subcommands (persistent flags) inherit all of the above.

Blast radius: CLI-only, additive, all subcommands; no behavior change for anyone currently using flags or the flag-derived names.

🤖 Generated with Claude Code

…PI_KEY env spellings

The auth env binding was derived purely from flag names (uri / apikeyid /
apikey), so only REARM_URI / REARM_APIKEYID / REARM_APIKEY worked -- while
the operator-facing docs (orientation.md section 1.1 and the agentic
workflow page) tell people to export REARM_URL / REARM_API_ID /
REARM_API_KEY, which the CLI silently ignored and then failed with
`unsupported protocol scheme ""`. Multiple agent sessions independently
re-discovered this and fell back to explicit -u/-i/-k flags.

Bind both spellings explicitly for the auth trio. Precedence, verified
empirically against a live instance: flags still override env; when both
spellings are set the flag-derived one (REARM_URI et al) wins; each
spelling authenticates alone, including on agent subcommands.

ReARM-Agentic-Session: cli-env-aliases-1785637582
ReARM-Agent: 62df357e-a3a4-4df5-82d4-049e629d1c6b
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@taleodor
taleodor merged commit a476f8e into main Aug 2, 2026
1 check passed
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.

2 participants