How gcwing/openbitfun works
OpenBitFun is a cross-device agent workspace. A user starts work in a desktop, CLI, or remote client; the agent runtime manages session context, selects and executes tools, and returns results to the conversation. The graph also preserves documented capabilities for harness modes, workspace access, Mini Apps, and remote control. Several product branches are documented but their implementations were not sampled, so those relationships are cited to the README; unsampled internals are represented only where the tree supports a path.
Main entry points: execution_engine.rs Execution engine · tool_pipeline.rs Tool pipeline · RemoteSessionManager.ts Remote sessions · desktop Desktop app
Components 26
User clients
- Desktop app
src/apps/desktop - CLI
src/apps/cli - Web workspace
src/web-ui - Conversation state
src/web-ui/src/flow_chat/store/FlowChatStore.ts
Agent runtime
- Session model
src/crates/assembly/core/src/agentic/core/message.rs - Execution engine
src/crates/assembly/core/src/agentic/execution/execution_engine.rs - Harness modes
src/crates/assembly/core/src/agentic - Workspace binding
src/crates/assembly/core/src/agentic/workspace.rs - Deep review policy
src/crates/assembly/core/src/agentic/deep_review_policy.rs - Edit constraints
src/crates/assembly/core/src/agentic/execution/edit_constraint_guard.rs
Tool execution
- Tool framework
src/crates/assembly/core/src/agentic/tools/framework.rs - Tool registry
src/crates/assembly/core/src/agentic/tools/registry.rs - Tool pipeline
src/crates/assembly/core/src/agentic/tools/pipeline/tool_pipeline.rs - Tool context
src/crates/assembly/core/src/agentic/tools/tool_context_runtime.rs - Tool result storage
src/crates/assembly/core/src/agentic/tools/tool_result_storage.rs - Computer use
src/crates/assembly/core/src/agentic/tools/computer_use_host.rs
Remote collaboration
- Relay service
src/apps/relay-server - Mobile web client
src/mobile-web - Relay HTTP client
src/mobile-web/src/services/RelayHttpClient.ts - Remote sessions
src/mobile-web/src/services/RemoteSessionManager.ts - Host stream transport
src/shared/relay-transport/HostStream.ts - SSH workspace state
src/crates/assembly/core/src/service/remote_ssh/workspace_state.rs
Workspace extensions
- Mini Apps
src/crates/assembly/core/src/miniapp - Agent hooks
src/crates/assembly/core/src/native_hooks.rs - Mini App marketplace
src/miniapp-market-web/src/App.tsx
Other components
- User
Connections 27
- User → Desktop app: starts work
README.md - User → CLI: starts work
README.md - User → Web workspace: controls tasks
README.md - Desktop app → Execution engine: runs tasks
README.md - CLI → Execution engine: shares execution
README.md - Web workspace → Conversation state: updates conversation
src/web-ui/src/flow_chat/hooks/useThreadGoalController.ts - Conversation state → Session model: holds session view
- Execution engine → Session model: manages turns
src/crates/assembly/core/src/agentic/execution/execution_engine.rs - Execution engine → Harness modes: applies task mode
README.md - Execution engine → Tool registry: selects tools
README.md - Tool registry → Tool framework: registers tools
src/crates/assembly/core/src/agentic/tools/mod.rs - Execution engine → Tool pipeline: executes calls
src/crates/assembly/core/src/agentic/execution/execution_engine.rs - Tool pipeline → Tool context: provides context
src/crates/assembly/core/src/agentic/tools/pipeline/tool_pipeline.rs - Tool pipeline → Tool result storage: stores results
src/crates/assembly/core/src/agentic/tools/pipeline/tool_pipeline.rs - Tool pipeline → Computer use: dispatches tools
src/crates/assembly/core/src/agentic/tools/pipeline/tool_pipeline.rs - Execution engine → Workspace binding: uses workspace
README.md - Execution engine → Deep review policy: supports review
README.md - Execution engine → Edit constraints: checks edits
src/crates/assembly/core/src/agentic/execution/execution_engine.rs - Mobile web client → Relay HTTP client: sends requests
src/mobile-web/src/services/RemoteSessionManager.ts - Relay HTTP client → Remote sessions: backs sessions
src/mobile-web/src/services/RemoteSessionManager.ts - Remote sessions → Relay service: controls host
README.md - Remote sessions → Host stream transport: uses stream
src/mobile-web/src/services/RemoteSessionManager.ts - Remote sessions → SSH workspace state: targets workspace
README.md - Execution engine → Agent hooks: customizes tasks
README.md - Execution engine → Mini Apps: builds Mini Apps
README.md - User → Mini App marketplace: discovers apps
README.md - Mini App marketplace → Mini Apps: offers apps
README.md