ContextQMD
Back to Ruflo

Ruflo Browser

plugins/ruflo-browser/commands/ruflo-browser.md

3.10.52.6 KB
Original Source

$ARGUMENTS Browser session management via RVF cognitive containers + AgentDB index. Parse the verb from $ARGUMENTS.

Usage: /ruflo-browser <verb> [args]

Verbs:

  1. ls [--query "<text>"] [--host <host>] [--verdict pass|fail|partial] List browser sessions. Backs onto AgentDB browser-sessions namespace.

    bash
    npx -y @claude-flow/cli@latest memory list --namespace browser-sessions
# or with semantic filter:
npx -y @claude-flow/cli@latest memory search --namespace browser-sessions --query "QUERY"

    For active (live) sessions, also call mcp__claude-flow__browser_session-list.

  2. show <session-id> Print the session manifest + last 20 trajectory entries + verdict.

    bash
    npx -y [email protected] rvf status <session-id>.rvf
npx -y [email protected] rvf segments <session-id>.rvf

    Then Read the trajectory.ndjson tail and the findings.md.

  3. replay <session-id> [--url <new-url>] [--mutate <json>] Invoke the browser-replay skill on the named session. When the browser_session_replay MCP tool ships, this verb shells through to it.

  4. export <session-id> [-o <path>] [--federate]

    bash
    npx -y [email protected] rvf export <session-id>.rvf -o <path>

    With --federate, also push via the ruflo-federation plugin.

  5. fork <session-id> [--name <new-name>]

    bash
    npx -y [email protected] rvf derive <session-id>.rvf <new-name>.rvf

    Lineage tracked. Cookies, selectors, templates inherited.

  6. purge <session-id> [--keep-manifest] Destroy the RVF container. Default keeps a redacted manifest in browser-sessions so future searches still find the trace; pass --no-keep-manifest to wipe completely.

  7. doctor Run the structural health check:

    bash
    bash plugins/ruflo-browser/scripts/smoke.sh

    Plus dependency probes:

    • Playwright runner reachable (mcp__claude-flow__browser_open against about:blank)
    • AgentDB controllers initialized (mcp__claude-flow__agentdb_health)
    • AIDefence loaded (mcp__claude-flow__aidefence_stats)
    • ruvector pinned to 0.2.25 (npx -y [email protected] --version)

Notes:

  • Verbs replay, fork, and the browser_session_* MCP tools are part of the v0.2.0 architecture but their MCP-tool implementation is pending (see ADR-0001 Verification §4 spike).
  • Until the lifecycle MCP tools ship, replay and fork operate at the RVF-container level; the actual browser drive is invoked through the browser-replay skill, not a single MCP call.
  • For interactive primitive operations (open/click/fill/eval) use the existing browser-record / browser-test / browser-extract skills, not this dispatcher.