How suman724/remote-browser-use works
Muse is a desktop browser-control workspace backed by a FastAPI service. The main workflow is a user starting or attaching to a session, then viewing browser frames and session updates while taking control or allowing an agent to act through browser tools. The backend owns session orchestration, browser access, lease and approval handling, and session history/settings persistence. The source index and excerpts support the main internal links; the renderer-to-backend connection is shown as unverified because the excerpts do not establish its route wiring.
Main entry points: session.py Session manager · main.py Service lifecycle · App.tsx Workspace shell · client.ts API client
Components 25
Desktop workspace
- Workspace shell
app/src/renderer/src/App.tsx - Browser view
app/src/renderer/src/components/BrowserStage.tsx - Run controls
app/src/renderer/src/components/RunRail.tsx - History view
app/src/renderer/src/components/HistoryView.tsx - Settings drawer
app/src/renderer/src/components/SettingsDrawer.tsx - API client
app/src/renderer/src/lib/client.ts - UI session state
app/src/renderer/src/state.ts - Wire protocol
app/src/renderer/src/lib/protocol.ts
Backend service
- REST routes
backend/muse_backend/api/routes.py - WebSocket API
backend/muse_backend/api/ws.py - Service lifecycle
backend/muse_backend/main.py - Python tools client
sdk/python/muse_tools/client.py
Browser automation
- Browser tools
backend/muse_backend/tools.py - Demo driver
backend/muse_backend/driver.py - Browser bridge
backend/muse_backend/browser/bridge.py - Browser provider
backend/muse_backend/browser/provider.py - Page snapshots
backend/muse_backend/browser/snapshot.py
Session state and safety
- Session manager
backend/muse_backend/session.py - Control lease
backend/muse_backend/lease.py - Risk checks
backend/muse_backend/risk.py - User settings
backend/muse_backend/user_settings.py - Profiles and history
backend/muse_backend/profile.py - Event recorder
backend/muse_backend/recorder.py
Other components
- User
- Steel Chromium service
Connections 37
- User → Workspace shell: uses
app/src/renderer/src/App.tsx - Workspace shell → Browser view: renders
app/src/renderer/src/App.tsx - Workspace shell → Run controls: renders
app/src/renderer/src/App.tsx - Workspace shell → History view: renders
app/src/renderer/src/App.tsx - Workspace shell → Settings drawer: renders
app/src/renderer/src/App.tsx - Workspace shell → API client: calls
app/src/renderer/src/App.tsx - Workspace shell → UI session state: dispatches
app/src/renderer/src/App.tsx - Browser view → UI session state: reads
app/src/renderer/src/components/BrowserStage.tsx - Run controls → UI session state: reads
app/src/renderer/src/components/RunRail.tsx - History view → API client: requests history
app/src/renderer/src/components/HistoryView.tsx - Settings drawer → API client: saves settings
app/src/renderer/src/components/SettingsDrawer.tsx - API client → Wire protocol: decodes frames
app/src/renderer/src/lib/client.ts - UI session state → Wire protocol: handles messages
app/src/renderer/src/state.ts - API client → REST routes: calls over HTTP
- API client → WebSocket API: connects over WebSocket
- Service lifecycle → REST routes: registers routes
backend/muse_backend/main.py - Service lifecycle → WebSocket API: registers routes
backend/muse_backend/main.py - Service lifecycle → Session manager: creates manager
backend/muse_backend/main.py - Service lifecycle → Browser provider: configures
backend/muse_backend/main.py - Service lifecycle → Profiles and history: starts
backend/muse_backend/main.py - Service lifecycle → Event recorder: creates
backend/muse_backend/main.py - Service lifecycle → User settings: loads
backend/muse_backend/main.py - REST routes → Session manager: serves session requests
backend/muse_backend/api/routes.py - REST routes → Browser tools: lists tools
backend/muse_backend/api/routes.py - REST routes → User settings: updates settings
backend/muse_backend/api/routes.py - WebSocket API → Session manager: routes client messages
- Session manager → Control lease: checks control
backend/muse_backend/session.py - Session manager → Browser tools: runs tool calls
backend/muse_backend/session.py - Session manager → Browser bridge: controls browser
backend/muse_backend/session.py - Session manager → Browser provider: creates browser session
backend/muse_backend/session.py - Session manager → Page snapshots: observes page
backend/muse_backend/session.py - Session manager → Demo driver: runs demo
backend/muse_backend/session.py - Session manager → Risk checks: checks actions
backend/muse_backend/session.py - Session manager → Event recorder: records events
backend/muse_backend/session.py - Browser tools → Browser bridge: acts through
backend/muse_backend/tools.py - Browser provider → Steel Chromium service: creates sessions
backend/muse_backend/browser/provider.py - Python tools client → REST routes: calls API