How mrhoosier23/starnet works
StarNet is a local-first desktop harness for creating bounded AI agents, arranging them into capability-scoped station teams, and running real model-and-tool work. The principal flow is station setup and routing, agent execution, then persistent records and a live station view; connected channels, scheduled work, deliverables, connectors, voice, and remote access extend it. The README and excerpts support the product boundaries and selected routing, provider, connector, and shell relationships; several subsystem links are documented capabilities rather than inspected call paths.
Main entry points: context.js Agent Context · app.js Station UI · pipeline.js Routing Plan · worldmodel.js Station Model
Components 23
Station & Routing
- Station UI
frontend/app/app.js - Station Model
frontend/app/worldmodel.js - Routing Plan
frontend/app/pipeline.js - Work Router
sidecar/routing/router.js
Agent Runs
- Agent Context
sidecar/context.js - Model Providers
sidecar/providers/provider.js - Capabilities & Tools
sidecar/capability/registry.js - Night Shift
sidecar - Recipes & Schedules
frontend/app - Agent Apps
sidecar/tools/builtin/apps.js
Connections
- OpenRouter
sidecar/providers/openrouter.js - MCP Connectors
sidecar/mcp/manager.js - MCP Tool Translator
sidecar/mcp/translate.js - Messaging Channels
sidecar/channels - Remote Access
sidecar/remote/relay-client.js - Voice
frontend/app/voice.js
State & Output
- Local Persistence
sidecar/persist/index.js - Spend & Run Ledgers
frontend/app - Deliverables Outbox
frontend/app/deliverables.js - Live Station View
frontend/app/worldrenderer.js
Desktop Shell
- Tauri Shell
src-tauri/src/main.rs - Desktop Lifecycle
src-tauri/src
Other components
- Commander
Connections 22
- Commander → Station UI: configures
README.md - Station UI → Routing Plan: defines layout
- Station Model → Routing Plan: projects geometry
frontend/app/pipeline.js - Work Router → Routing Plan: compiles with
sidecar/routing/router.js - Work Router → Agent Context: dispatches work
- Agent Context → Model Providers: requests model work
- Model Providers → OpenRouter: supports provider
sidecar/providers/openrouter.js - Agent Context → Capabilities & Tools: uses tools
- Capabilities & Tools → MCP Connectors: offers connectors
- MCP Connectors → MCP Tool Translator: translates tools
sidecar/mcp/manager.js - Commander → Messaging Channels: messages remotely
README.md - Commander → Remote Access: connects remotely
README.md - Commander → Night Shift: arms unattended work
README.md - Commander → Recipes & Schedules: launches scheduled work
README.md - Commander → Voice: speaks to station
README.md - Agent Context → Agent Apps: builds apps
sidecar/tools/builtin/apps.js - Agent Context → Local Persistence: persists state
README.md - Local Persistence → Spend & Run Ledgers: stores records
- Agent Context → Deliverables Outbox: produces files
README.md - Station Model → Live Station View: projects live state
README.md - Tauri Shell → Desktop Lifecycle: manages lifecycle
src-tauri/src/main.rs - Tauri Shell → Station UI: opens web app
src-tauri/src/main.rs