How aaswordman/operit2 works
Operit2 is a cross-device personal Agent: a user starts a conversation or task on a CoreNode, whose Core coordinates model requests and Host capabilities; results and persisted context can then be synchronized for continuation on another node. The repository also includes CLI/TUI and Flutter access surfaces, extension runtimes, data migration, and ESP32 edge services. The README documents several architectural relationships and capabilities that were not sampled in source; those links are cited to the README rather than implying inspection of unsampled implementations.
Main entry points: application Core runtime · mod.rs CLI operations · main.rs CLI entry · link.rs Link commands
Components 22
Access surfaces
- CLI entry
apps/cli/src/main.rs - CLI operations
apps/cli/src/cli/mod.rs - Terminal UI
apps/cli/src/tui/core/app.rs - Flutter app
apps/flutter/app
Agent runtime
- Core runtime
core/crates/runtime/application - Local Core proxy
apps/cli/src/core_proxy.rs - Model providers
core/crates/provider - Local model install
core/crates/provider/local-model/src/LocalEngineDownload.rs - Runtime persistence
core/crates/persistence/store/src/RuntimeStorageHost.rs - Backup and migration
core/crates/command/core/src/commands/storage.rs
Device collaboration
- Link commands
apps/cli/src/cli/link.rs - Peer discovery
hosts/common/operit-host-native-common/src/ServiceDiscovery.rs - PeerLink transport
core/crates - Space sync
core/crates
Extensions
- JavaScript runtime
core/crates/plugin/javascript-bridge/src/javascript/JsEngine.rs - Skill manager
core/crates/tool/services/src/tools/skill/SkillManager.rs - Workflow package
plugins/packages/buildin/workflow/src/engine.ts - Worldbook package
plugins/packages/external/worldbook/src/main.ts
Platform capabilities
- Host capabilities
hosts - ESP32 edge node
apps/esp32/src/main.rs
Other components
- Personal user
- Model service
Connections 23
- Personal user → CLI entry: starts task
apps/cli/src/main.rs - CLI entry → CLI operations: routes CLI
apps/cli/src/main.rs - CLI entry → Terminal UI: routes TUI
apps/cli/src/main.rs - CLI operations → Local Core proxy: creates local Core
apps/cli/src/cli/mod.rs - Terminal UI → Local Core proxy: uses Core proxy
apps/cli/src/tui/core/app.rs - Flutter app → Core runtime: hosts CoreNode
README.md - Local Core proxy → Core runtime: calls runtime
apps/cli/src/core_proxy.rs - Core runtime → Host capabilities: uses capabilities
README.md - Core runtime → Model providers: requests model
README.md - Model providers → Model service: calls service
- Local model install → Host capabilities: downloads via Host
core/crates/provider/local-model/src/LocalEngineDownload.rs - Core runtime → Runtime persistence: persists state
README.md - CLI operations → Backup and migration: exports and restores
apps/cli/src/cli/mod.rs - CLI operations → Link commands: offers link commands
apps/cli/src/cli/mod.rs - Link commands → Peer discovery: discovers peers
README.md - Link commands → PeerLink transport: connects nodes
README.md - PeerLink transport → Space sync: carries sync traffic
README.md - Space sync → Runtime persistence: syncs records
README.md - Core runtime → JavaScript runtime: runs extensions
- Core runtime → Skill manager: loads skills
core/crates/tool/services/src/tools/skill/SkillManager.rs - JavaScript runtime → Workflow package: executes package
- JavaScript runtime → Worldbook package: executes package
- ESP32 edge node → Host capabilities: provides edge capability
README.md