Skip to content

docs(agents): add External Agents section (Experimental)#3

Open
cindyrui71 wants to merge 4 commits into
mainfrom
maggie/external-agents-section
Open

docs(agents): add External Agents section (Experimental)#3
cindyrui71 wants to merge 4 commits into
mainfrom
maggie/external-agents-section

Conversation

@cindyrui71

Copy link
Copy Markdown
Contributor

What

New docs page at /features/agents/external/ — under Agents, after Runtime — documenting external agents: agents you run yourself (your machine/runtime) and connect to Raft via raft agent login, as opposed to managed agents on a Raft-connected computer.

Covers:

  • What an external agent is (vs managed) — full server member once connected
  • Creating one — the Create External Agent entry in the sidebar + menu
  • Connectingraft agent login device-auth (one-shot + two-step), RAFT_PROFILE, and the External Setup card states (Waiting for login → Credential minted → Connected)
  • Setup pathsHermes Agent (Nous Research) as a real, usable path (~/.hermes/.env + adapter auto-spawns raft agent bridge); Claude Code marked Coming soon; Other agents generic raft CLI path
  • Experimental Badge (h1) + flask sidebar icon, matching §5 / Joint Channels / Login-with-Raft

Verification

  • Behavior-verified against slock-product staging: create flow, raft agent login flags, External Setup state machine, all confirmed against AgentDetailPanel.tsx / CreateAgentDialog.tsx / Sidebar.tsx.
  • Hermes setup verified against the official Nous Research docs (hermes-agent.nousresearch.com/docs/user-guide/messaging/raft).
  • pnpm build passes; render-verified (Badge, nav, both Nous links live, state labels, full wait command, clean agent .md artifact).

Open / notes for review (@xxchan)

  • Activity-status caveat kept at the bottom — external agents' activity indicator can be inaccurate (known getActivity gap per @Huaihuai). Please confirm wording is fair / whether this is the connection issue flagged.
  • GA / publish timing is a product call (cindyz + tygg). Page is marked Experimental.
  • Screenshots pending (Koda) — to be wired separately by Vivian.

HOLD merge until cindyz/xxchan sign-off in Slock — opening for preview + review, not self-merging.

cindyrui71 and others added 2 commits June 21, 2026 00:19
New page at /features/agents/external/ covering external agents — agents
you run yourself and connect to Raft via `raft agent login`. Documents
the create flow, device-auth connection + RAFT_PROFILE, the External
Setup card states, and setup paths (Hermes usable; Claude Code coming
soon; generic raft CLI path). Behavior-verified against staging.

- nav entry under Agents (after Runtime)
- Experimental badge + flask sidebar icon (matches §5 / Joint Channels)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jun 20, 2026

Copy link
Copy Markdown

Deploying raft-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: ed05c40
Status: ✅  Deploy successful!
Preview URL: https://5bd02fe4.raft-docs.pages.dev
Branch Preview URL: https://maggie-external-agents-secti.raft-docs.pages.dev

View logs

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