How shogo-labs/shogo-ai works
Shogo is a platform for building and operating AI agents, combining client apps, a Hono API, agent and project runtimes, and an SDK. A typical workflow starts in a client, reaches the API for platform orchestration, then runs agent work and project code in separate runtime layers. The repository also includes bare-metal VM execution, real-time sync, and SDK memory search. The README supports the platform-level links; sampled source supports runtime configuration and sync-client behavior. Unsampled route and service internals limit finer-grained call links.
Main entry points: server.ts Hono API · manager.ts Workspace runtime · index.tsx Mobile client · main.ts Desktop client
Components 21
Client apps
- Mobile client
apps/mobile/app/(app)/index.tsx - Desktop client
apps/desktop/src/main.ts
Platform control
- Hono API
apps/api/src/server.ts - Authentication
apps/api/src/auth.ts - API routes
apps/api/src/routes - Database adapter
apps/api/src/lib/prisma.ts - Project settings
apps/api/src/lib/project-settings.ts - Agent model defaults
apps/api/src/lib/runtime/agent-model-defaults.ts - Cloud federation
apps/api/src/lib/federated-upstream.ts
Runtime execution
- Agent runtime
packages/agent-runtime/src/index-engine.ts - Preview manager
packages/agent-runtime/src/preview-manager.ts - Workspace runtime
apps/api/src/lib/runtime/manager.ts - Workspace environment
apps/api/src/lib/runtime/build-workspace-env.ts - Remote SSH
apps/api/src/lib/remote-ssh/remote-runtime.ts - Metal VM manager
apps/metal-agent/src/firecracker-vm-manager.ts
Sync and data
- Sync hook
packages/shared-app/src/hooks/useSyncClient.ts - Sync client
packages/shared-app/src/services/sync-client.ts
Developer SDK
- Memory search
packages/sdk/src/memory/engine.ts - Route generator
packages/sdk/src/generators/routes-generator.ts
Other components
- Platform user
- External integrations
Connections 18
- Platform user → Mobile client: uses
README.md - Platform user → Desktop client: uses
README.md - Mobile client → Hono API: API requests
- Desktop client → Hono API: API requests
- Hono API → Authentication: authenticates
- Hono API → API routes: routes requests
- Hono API → Database adapter: persists data
- Hono API → Workspace runtime: orchestrates
README.md - Hono API → Agent runtime: runs agents
README.md - Workspace runtime → Workspace environment: builds environment
apps/api/src/lib/runtime/manager.ts - Workspace runtime → Agent model defaults: resolves defaults
apps/api/src/lib/runtime/manager.ts - Agent model defaults → Cloud federation: fetches defaults
apps/api/src/lib/runtime/agent-model-defaults.ts - Agent runtime → External integrations: uses tools
README.md - Workspace runtime → Remote SSH: manages remote
apps/api/src/lib/runtime/manager.ts - External integrations → Metal VM manager: runs on
- Sync hook → Sync client: creates and connects
packages/shared-app/src/hooks/useSyncClient.ts - Memory search → External integrations: searches memory
- Route generator → Hono API: supports integration