How milad-alizadeh/argo-universal works
Argo is a local coding-agent cockpit: a cross-platform app connects to a local server that manages Claude and Codex sessions, session feeds, and persistent data. The main workflow is viewing or creating a session, sending prompts or controls through the API, running the agent, and streaming session/feed updates back to the client. The desktop shell supervises the local server; the server also exposes system information and owns git-related capability. Some UI and integration wiring was not sampled, so those links are marked unverified rather than asserted.
Main entry points: machine.ts Server engine · session-machine.ts Session runtime · index.tsx Universal app · server-services.ts Service wiring
Components 26
Client apps
- Universal app
apps/universal-app/src/app/index.tsx - Session screen
packages/client/src/screens/SessionScreen.tsx - Projects screen
packages/client/src/screens/ProjectsScreen.tsx - Connection client
packages/client/src/connection/open-connection.ts - Desktop shell
apps/desktop/src/main/main.ts - Server lifecycle
apps/desktop/src/main/server-machine.ts - tRPC client
packages/client/src/trpc/create-trpc-client.ts
API and contracts
- API contracts
packages/contracts/src/index.ts - tRPC API
packages/api/src/trpc.ts - API routers
packages/api/src/sessions/router.ts
Server runtime
- Service wiring
apps/server/src/services/server-services.ts - Server engine
apps/server/src/engine/machine.ts - Engine supervisor
apps/server/src/supervisor/engine-process.ts - HTTP server
apps/server/src/engine/http-server.ts - Git capability
packages/git/src/index.ts - System service
apps/server/src/services/system/index.ts
Session and agents
- Session service
apps/server/src/services/sessions/session-service.ts - Session registry
apps/server/src/services/sessions/registry-machine.ts - Session runtime
apps/server/src/services/sessions/session-machine.ts - Agent adapters
packages/agents/src/agent-machine.ts - Claude and Codex
packages/agents/claude/connect.ts
Feed and storage
- Feed service
apps/server/src/services/feed/feed-service.ts - Feed runtime
apps/server/src/services/feed/feed-machine.ts - Database writer
apps/server/src/services/feed/writer-machine.ts - Database
packages/db/src/database.ts
Other components
- User
Connections 34
- User → Universal app: uses
README.md - Universal app → Session screen: routes to
- Universal app → Projects screen: routes to
- Session screen → tRPC client: requests data
- Projects screen → tRPC client: requests data
- Desktop shell → Server lifecycle: starts and stops
apps/desktop/src/main/main.ts - Server lifecycle → Engine supervisor: supervises
apps/desktop/src/main/server-machine.ts - Universal app → Desktop shell: runs inside
README.md - tRPC client → tRPC API: calls
packages/client/src/trpc/create-trpc-client.ts - API routers → tRPC API: uses procedures
packages/api/src/sessions/router.ts - tRPC API → Service wiring: uses services
packages/api/src/trpc.ts - API routers → API contracts: validates inputs
packages/api/src/sessions/router.ts - Service wiring → Session service: creates
apps/server/src/services/server-services.ts - Service wiring → Feed service: creates
apps/server/src/services/server-services.ts - Service wiring → System service: creates
apps/server/src/services/server-services.ts - Engine supervisor → Server engine: forks process
apps/server/src/supervisor/engine-process.ts - Server engine → Session registry: starts
apps/server/src/engine/machine.ts - Server engine → Database writer: starts
apps/server/src/engine/machine.ts - Server engine → HTTP server: starts
apps/server/src/engine/machine.ts - Server engine → Database: opens
apps/server/src/engine/machine.ts - Session service → Session registry: sends commands
apps/server/src/services/sessions/session-service.ts - Session registry → Session runtime: opens sessions
apps/server/src/services/sessions/registry-machine.ts - Session runtime → Agent adapters: invokes
apps/server/src/services/sessions/session-machine.ts - Agent adapters → Claude and Codex: connects to
- Session runtime → Feed runtime: sends changes
apps/server/src/services/sessions/session-machine.ts - Session runtime → Database writer: writes turn updates
apps/server/src/services/sessions/session-machine.ts - Feed service → Feed runtime: reads live state
apps/server/src/services/feed/feed-service.ts - Feed service → Session runtime: opens session
apps/server/src/services/feed/feed-service.ts - Feed runtime → Database writer: queues writes
apps/server/src/services/feed/feed-machine.ts - Database writer → Database: writes batches
apps/server/src/services/feed/writer-machine.ts - Feed service → Database: reads rows
apps/server/src/services/feed/feed-service.ts - Session service → Database: reads sessions
apps/server/src/services/sessions/session-service.ts - Server engine → Git capability: provides git capability
- tRPC client → HTTP server: connects locally