How ysunyang979-sys/nexus-web-chatgpt works
Nexus is a local AI control plane: an AI client sends MCP requests through the server, which brokers work to an outbound-connected local Runner; the Runner applies project boundaries and performs development operations. The desktop control center lets the local user configure projects, tokens, approvals, and integrations. The graph includes the README’s major capabilities and a few documented internal layers; sampled excerpts are partial, so uncertain module-to-module calls are omitted.
Main entry points: router.ts RPC handlers · tools MCP tools · rpc-service.ts Runner RPC service · evaluator.ts Policy and sandbox
Components 22
Client Access
- Desktop control center
apps/desktop/src/App.tsx - Local bridge
apps/bridge/src/server.ts
Control Plane
- MCP interface
apps/server/src/mcp/server.ts - MCP tools
apps/server/src/mcp/tools - Runner RPC service
apps/server/src/runner/rpc-service.ts - Runner connection
apps/server/src/routes/runner-ws.ts
Local Execution
- Runner daemon
apps/runner/src/runner.ts - RPC handlers
apps/runner/src/rpc/router.ts - Project registry
apps/runner/src/projects/registry.ts - Filesystem tools
apps/runner/src/filesystem/service.ts - Git and worktrees
apps/runner/src/git/service.ts - Processes and terminals
apps/runner/src/process/service.ts - Jobs and runtimes
apps/runner/src/jobs/manager.ts - Code intelligence
apps/runner/src/lsp/manager.ts
Workflow Services
- Approval gates
apps/runner/src/approvals/manager.ts - Workflow sessions
apps/server/src/session/manager.ts - Skills
apps/server/src/skills/skill-registry.ts
Security and State
- Policy and sandbox
packages/security/src/policy/evaluator.ts - Server persistence
apps/server/src/db/schema.ts - Shared RPC protocol
packages/protocol/src/runner/rpc.ts
Other components
- AI client
- Local user
Connections 23
- AI client → MCP interface: sends MCP requests
- Desktop control center → Local user: presents controls
- Local user → Desktop control center: configures system
- Local user → Project registry: authorizes locally
- MCP interface → MCP tools: dispatches tools
- MCP tools → Runner RPC service: requests runner work
- Runner RPC service → Runner connection: sends RPC
- Runner connection → Runner daemon: carries messages
- Runner daemon → RPC handlers: dispatches requests
- RPC handlers → Project registry: queries projects
- RPC handlers → Filesystem tools: invokes file operations
- RPC handlers → Git and worktrees: invokes repository operations
- RPC handlers → Processes and terminals: invokes process tools
- RPC handlers → Jobs and runtimes: invokes execution tools
- RPC handlers → Code intelligence: requests code intelligence
- RPC handlers → Approval gates: manages approvals
- MCP tools → Workflow sessions: serves session tools
- MCP tools → Skills: serves skill tools
- Workflow sessions → Server persistence: stores checkpoints
- Policy and sandbox → Filesystem tools: constrains paths
- Policy and sandbox → Processes and terminals: evaluates commands
- Shared RPC protocol → Runner RPC service: defines RPC types
- Shared RPC protocol → RPC handlers: defines RPC types