How usefulsoftwareco/executor works
Executor provides a shared, policy-governed integration catalog that agents access over MCP. The principal workflow is to configure an integration, create an authenticated connection, set tool policies, then discover and invoke tools; executions may pause for approval and resume. The monorepo packages that functionality for local, desktop, cloud, and self-hosted deployments. Relationships below follow explicit README statements and the shown composition excerpts; unsampled subsystems are included where documented, but their internal call paths are not inferred.
Main entry points: executor-app.ts Executor API · engine.ts Execution engine · app.ts Local API runtime · connection.ts Connections and auth
Components 21
Agent and UI
- Web console
packages/react/src/console-routes.ts - Executor CLI
apps/cli/src/main.ts
Integration and execution
- Integration plugins
packages/plugins/openapi/src/api/handlers.ts - MCP integration
packages/plugins/mcp/src/api/handlers.ts - Connections and auth
packages/core/sdk/src/connection.ts - Tool policies
packages/core/sdk/src/policies.ts - Tool catalog
packages/core/api/src/tools/api.ts - Execution engine
packages/core/execution/src/engine.ts - Tool invoker
packages/core/execution/src/tool-invoker.ts - Approval and resume
packages/core/execution/src/engine.ts
Shared platform
- TypeScript SDK
packages/core/sdk/src/client.ts - Executor API
packages/core/api/src/server/executor-app.ts
Local runtime
- Local API runtime
apps/local/src/app.ts - Local MCP runtime
apps/local/src/main.ts - Local database
apps/local/src/db/owned-database.ts - Local daemon
apps/cli/src/daemon.ts - Desktop app
apps/desktop/src/main/index.ts
Hosted runtimes
- Executor Cloud
apps/cloud/src/app.ts - Self-host server
apps/host-selfhost/src/app.ts - Cloudflare host
apps/host-cloudflare/src/app.ts
Other components
- MCP agent
Connections 26
- Web console → Executor API: manages catalog
README.md - Executor CLI → Executor API: calls tools
README.md - TypeScript SDK → Executor API: configures and invokes
README.md - Executor API → Integration plugins: loads plugins
- Executor API → MCP integration: loads plugins
- Integration plugins → Connections and auth: defines integration instances
README.md - MCP integration → Connections and auth: defines integration instances
README.md - Web console → Connections and auth: creates connections
README.md - Connections and auth → Tool catalog: provides tools
README.md - Web console → Tool policies: sets policies
README.md - Tool catalog → MCP agent: exposes tools over MCP
README.md - MCP agent → Execution engine: invokes tools
README.md - Execution engine → Tool invoker: dispatches execution
packages/core/execution/src/engine.ts - Execution engine → Approval and resume: pauses and resumes
packages/core/execution/src/engine.ts - Executor CLI → Local daemon: starts daemon
README.md - Local daemon → Local API runtime: serves locally
- Local API runtime → Local MCP runtime: boots MCP runtime
apps/local/src/main.ts - Local MCP runtime → Execution engine: creates engine
apps/local/src/main.ts - Desktop app → Local API runtime: packages same runtime
README.md - Local API runtime → Local database: uses local data store
- Executor Cloud → Executor API: hosts API
- Self-host server → Executor API: hosts API
- Cloudflare host → Executor API: hosts API
apps/host-cloudflare/src/app.ts - MCP agent → Executor Cloud: connects over MCP
README.md - MCP agent → Self-host server: connects over MCP
README.md - MCP agent → Cloudflare host: connects over MCP
README.md