Skip to content

Update device agent Remote sessions docs for Claude Code on the web - #108

Closed
subomi wants to merge 1 commit into
mainfrom
docs/device-agent-remote-sessions
Closed

Update device agent Remote sessions docs for Claude Code on the web#108
subomi wants to merge 1 commit into
mainfrom
docs/device-agent-remote-sessions

Conversation

@subomi

@subomi subomi commented Aug 20, 2026

Copy link
Copy Markdown

Summary

  • Rewrote the "Claude Code on the web" section of docs/ai-control-plane/org-admin/device-agent.mdx to match the shipped Remote sessions flow: a platform tile in the dashboard's Device Agent setup opens a three-step wizard (shared Anthropic-hosted environment with Custom network access, a generated self-contained setup script, org default configuration).
  • The setup script section now describes what the dashboard-generated script actually does: installs the pinned, checksum-verified speakeasyd daemon, writes root-only /etc/speakeasy/managed.json, and registers a flock-guarded SessionStart hook that revives the daemon in each session (Anthropic snapshots files, not processes). Everything after daemon start is the agent's normal policy-sync loop.
  • Removed stale references to the earlier architecture (device-agent CLI commands, helper package, separately-merged SessionStart snippet, CLAUDE_CODE_REMOTE gating).
  • Cleaned up related mentions in docs/ai-control-plane/getting-started/index.mdx, docs/ai-control-plane/reference/device-agent/index.mdx, docs/ai-control-plane/distribute/plugins/anthropic.mdx, and docs/ai-control-plane/org-admin/ai-integrations/anthropic-compliance.mdx.

Implementation: speakeasy-api/gram#5489.

Test plan

  • Verify MDX renders correctly (Callout components, code blocks, heading anchors)
  • Confirm #claude-code-on-the-web anchor links from the four cross-referencing pages still resolve

Made with Cursor

Documents the shipped architecture: a Remote sessions tile in the
dashboard opens a three-step walkthrough (shared environment with
Custom network access, a generated self-contained setup script, org
default), and the script itself installs the pinned daemon, writes
managed enrollment, and registers the SessionStart hook that revives
the daemon in each session.

Co-authored-by: Cursor <cursoragent@cursor.com>
@subomi
subomi requested a review from a team as a code owner August 20, 2026 17:56
@subomi subomi closed this Aug 20, 2026
@subomi
subomi deleted the docs/device-agent-remote-sessions branch August 20, 2026 18:06
@subomi

subomi commented Aug 20, 2026

Copy link
Copy Markdown
Author

Closing — this was opened against the wrong repo. The device agent documentation lives in the marketing site repo; the change is moving there.

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.

1 participant