How ariakage/soyo-harness works
Soyo Harness is a Rust agent runtime for programming and general tasks. Users submit work through the CLI or TUI; the shared runtime drives model/tool execution, with approvals, modes, and services around that loop. The tree also contains a desktop GUI and substantial memory, browser, plugin, and MCP subsystems. The supplied excerpts show the CLI and TUI runtime calls and runtime-service imports; connections to unsampled subsystems are omitted rather than inferred from names or layout.
Main entry points: runtime_services.rs Runtime services · controller.rs TUI controller · mod.rs Agent runtime · main.rs CLI
Components 21
User interfaces
- CLI
crates/soyo-cli/src/main.rs - TUI controller
crates/soyo-tui/src/controller.rs - TUI rendering
crates/soyo-tui/src/view/mod.rs - Desktop app
desktop/src/App.tsx - Desktop state
desktop/src/store/useAppStore.ts - Desktop bindings
desktop/src/bindings.ts - Desktop host
crates/soyo-host/src/service.rs - Desktop commands
desktop/src-tauri/src/commands.rs
Agent runtime
- Agent runtime
crates/soyo-core/src/runtime/mod.rs - Runtime services
crates/soyo-core/src/runtime_services.rs - Approvals
crates/soyo-core/src/approvals.rs - Work modes
crates/soyo-core/src/mode.rs
Runtime capabilities
- Tool execution
crates/soyo-core/src/execution.rs - Browser tools
crates/soyo-core/src/browser/mod.rs - Network policy
crates/soyo-core/src/network.rs - Plugin runtime
crates/soyo-core/src/plugin_runtime.rs - Hooks
crates/soyo-core/src/hooks.rs - MCP integration
crates/soyo-core/src/mcp.rs
State and services
- Global memory
crates/soyo-core/src/global_memory/query.rs - Session storage
crates/soyo-core/src/sqlite.rs
Other components
- User
Connections 18
- User → CLI: submits work
- User → TUI controller: interacts
- CLI → Agent runtime: runs task
crates/soyo-cli/src/main.rs - TUI controller → Agent runtime: runs or compacts
crates/soyo-tui/src/controller.rs - TUI controller → TUI rendering: updates state
- Desktop app → Desktop state: uses state
desktop/src/App.tsx - Desktop state → Desktop bindings: invokes commands
desktop/src/store/useAppStore.ts - Desktop bindings → Desktop commands: calls IPC
desktop/src/bindings.ts - Desktop commands → Desktop host: dispatches to host
- Agent runtime → Runtime services: uses services
- Runtime services → Approvals: imports
crates/soyo-core/src/runtime_services.rs - Runtime services → Work modes: imports
crates/soyo-core/src/runtime_services.rs - Runtime services → Tool execution: imports
crates/soyo-core/src/runtime_services.rs - Runtime services → Browser tools: imports
crates/soyo-core/src/runtime_services.rs - Runtime services → Network policy: imports
crates/soyo-core/src/runtime_services.rs - Runtime services → Plugin runtime: imports
crates/soyo-core/src/runtime_services.rs - Runtime services → Hooks: imports
crates/soyo-core/src/runtime_services.rs - Runtime services → MCP integration: configures servers
crates/soyo-core/src/runtime_services.rs