Skip to content

feat(framework): label the dashboard session link honestly (#221)#222

Merged
suleimansh merged 1 commit into
mainfrom
feat/honest-session-link-214
Jul 4, 2026
Merged

feat(framework): label the dashboard session link honestly (#221)#222
suleimansh merged 1 commit into
mainfrom
feat/honest-session-link-214

Conversation

@suleimansh

Copy link
Copy Markdown
Member

What

Our runs are headless, which is deliberately not Remote-Controlled, so the default https://claude.ai/code link is a generic Claude Code entry point, not a live per-run session. The dashboard used to render it as a "live session" anchor, which overpromises.

  • Dashboard now labels the generic default Open Claude Code; keeps "live session" only for a real user-supplied --session-link.
  • Still shows the real session id (the local transcript id, usable with claude --resume).
  • README session section rewritten to be accurate: to steer live in the browser, start your own claude auth login + claude --remote-control --name <run> session and open it from claude.ai/code (a separate process from a run).

Why

Follow-up to the #214 de-risk. Testing against Claude Code 2.1.201 confirmed the real-URL capture #214 asked for is infeasible:

  • Headless -p + --remote-control: flag silently ignored, no URL emitted (only a local UUID session_id).
  • Interactive Remote Control exposes no machine-readable URL (TUI-only) and claude remote-control refuses automation tokens ("requires a full-scope login token").

So Remote Control is a user-initiated steer handoff, not something our headless orchestrator can deep-link into. This PR makes the dashboard say that honestly. Corrects #212's overpromise.

Closes #221.

Our headless runs are not Remote-Controlled, so the default claude.ai/code
link is a generic entry point, not a live per-run session. Label it
"Open Claude Code" and keep "live session" only for a real --session-link.
Rewrite the README session section to document the user-initiated
claude auth login + --remote-control steer path. Corrects #212's overpromise;
follow-up to the #214 de-risk.

Closes #221
@suleimansh suleimansh added enhancement New feature or request priority: medium Worth doing, not urgent labels Jul 4, 2026
@suleimansh suleimansh self-assigned this Jul 4, 2026
@suleimansh suleimansh merged commit c7eae83 into main Jul 4, 2026
2 checks passed
@suleimansh suleimansh deleted the feat/honest-session-link-214 branch July 4, 2026 20:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request priority: medium Worth doing, not urgent

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Label the dashboard session link honestly + document the Remote Control steer path

1 participant