How clawdi-ai/clawdi works
Clawdi brings cloud-hosted and locally connected AI agents into one dashboard. Users deploy or connect an agent, then manage its sessions and durable memories, projects and skills, vaults, connectors, and messaging channels; hosted usage also includes provider setup and billing. The graph covers the dashboard, API, connected-agent sync, and hosted-agent capabilities. Backend and hosted feature links are shown at directory level where implementation was not sampled; those links reflect documented product responsibilities, not inspected call paths.
Main entry points: client.tsx Web dashboard · main.py FastAPI service · sync-engine.ts CLI and adapters · api.ts Web API client
Components 18
User interfaces
- Web dashboard
apps/web/src/client.tsx - Desktop app
apps/desktop/src/main.ts - Web API client
apps/web/src/lib/api.ts
Agent runtimes
- CLI and adapters
packages/cli/src/serve/sync-engine.ts - Connected agent
- Cloud agent
apps/web/src/hosted/runtimes.ts
API and data
- FastAPI service
backend/app/main.py - PostgreSQL
Agent context
- Sessions and memories
apps/web/src/components/sessions/session-feed.tsx - Projects and resources
apps/web/src/components/projects/projects-surface.tsx - Skills
apps/web/src/components/skills/skill-card.tsx - Vaults
apps/web/src/components/vault/vaults-surface.tsx - MCP connectors
apps/web/src/components/connectors/connectors-surface.tsx
Hosted operations
- Messaging channels
apps/web/src/hosted/v2/channels/channels-page.tsx - AI providers
apps/web/src/hosted/v2/ai-providers/ai-providers-page.tsx - Hosted billing
apps/web/src/hosted/billing/subscription/subscription-page.tsx
Other components
- User
- Stripe
Connections 18
- User → Web dashboard: uses
- User → Desktop app: uses
- User → Connected agent: connects
- User → Cloud agent: deploys
- Web dashboard → Web API client: requests
- Web API client → FastAPI service: calls
- CLI and adapters → Connected agent: scans sessions
- CLI and adapters → FastAPI service: syncs sessions and skills
- FastAPI service → PostgreSQL: reads and writes
- Web dashboard → Sessions and memories: manages
- Web dashboard → Projects and resources: manages
- Web dashboard → Skills: manages
- Web dashboard → Vaults: manages
- Web dashboard → MCP connectors: configures
- Web dashboard → Messaging channels: configures
- Web dashboard → AI providers: configures
- Web dashboard → Hosted billing: manages
- Hosted billing → Stripe: processes payments