How zhangcongmr/clover works
Clover is a browser-based development assistant paired with a local proxy agent. The main workflow is using the assistant’s editor, terminal, and ACP chat to work with local projects through the agent; the agent exposes file and agent-session APIs and can connect to external ACP processes. The monorepo also contains community, account, and service-management surfaces. Relationships below rely on README statements and the supplied source index or excerpts; unsampled modules are represented by their exact tree paths, with uncertain links omitted.
Main entry points: server.ts Agent server · acp-routes.ts ACP API routes · app.component.ts Browser assistant · session-manager.ts ACP sessions
Components 30
Assistant app
- Browser assistant
packages/assistant/src/app/app.component.ts - Core services
packages/assistant/src/app/core.service.ts - ACP client
packages/assistant/src/app/shared/acp/acp.service.ts - ACP chat UI
packages/assistant/src/app/shared/acp/acp-chat.component.ts - Editor and terminal
packages/assistant/src/app/shared/notebook/notebook.component.ts - Server manager
packages/assistant/src/app/shared/server-manager/server-manager.component.ts - Service manager
packages/assistant/src/app/shared/service-manager/service-manager.component.ts - MCP manager
packages/assistant/src/app/shared/mcp-manager/mcp-manager.component.ts - Skill manager
packages/assistant/src/app/shared/skill-manager/skill-manager.component.ts
Local proxy agent
- Agent server
packages/agent/src/server.ts - Local file API
packages/agent/src/api/routes.ts - Token security
packages/agent/src/api/middleware.ts - File operations
packages/agent/src/agent/file-service.ts - PTY manager
packages/agent/src/agent/pty-manager.ts - ACP API routes
packages/agent/src/api/acp-routes.ts
Agent integrations
- ACP sessions
packages/agent/src/acp/session-manager.ts - Agent registry
packages/agent/src/acp/agent-registry.ts - ACP process client
packages/agent/src/acp/sse-client.ts - SSE events
packages/agent/src/acp/sse-manager.ts - MCP registry
packages/agent/src/mcp/registry.ts - Skill registry
packages/agent/src/skills/registry.ts
Web surfaces
- Community widget
packages/community-widget/src/app/App.tsx - Home dashboard
packages/home/src/app/App.tsx - Editor surface
packages/editor/src/app/App.tsx - Account flows
packages/signin/src/app/App.tsx
Shared services
- Redis or memory
packages/agent/src/redis/client.ts - Shared contracts
packages/common/src/model.ts - Supabase auth
supabase/functions/server/node_auth_api.tsx
Other components
- Developer
- External ACP agent
Connections 29
- Developer → Browser assistant: uses
README.md - Browser assistant → Core services: uses services
- Browser assistant → ACP client: starts ACP chat
- ACP client → Agent server: connects to proxy
- Browser assistant → Editor and terminal: offers tools
README.md - Agent server → Local file API: registers routes
packages/agent/src/server.ts - Agent server → ACP API routes: registers routes
packages/agent/src/server.ts - Agent server → PTY manager: creates manager
packages/agent/src/server.ts - Local file API → File operations: handles file requests
packages/agent/src/api/routes.ts - Local file API → Token security: guards requests
packages/agent/src/api/routes.ts - Token security → Token security: verifies tokens
packages/agent/src/api/middleware.ts - ACP API routes → ACP sessions: manages sessions
packages/agent/src/api/acp-routes.ts - ACP API routes → SSE events: streams events
packages/agent/src/api/acp-routes.ts - ACP API routes → Agent registry: selects agents
packages/agent/src/api/acp-routes.ts - ACP API routes → MCP registry: uses registry
packages/agent/src/api/acp-routes.ts - ACP sessions → Agent registry: gets connections
packages/agent/src/acp/session-manager.ts - ACP sessions → Redis or memory: publishes prompts
packages/agent/src/acp/session-manager.ts - ACP sessions → ACP process client: sends ACP messages
packages/agent/src/acp/session-manager.ts - Agent registry → ACP process client: creates clients
packages/agent/src/acp/agent-registry.ts - ACP process client → External ACP agent: runs process
- SSE events → Redis or memory: subscribes events
packages/agent/src/acp/sse-manager.ts - Agent server → MCP registry: initializes registry
packages/agent/src/server.ts - Agent server → Skill registry: initializes registry
packages/agent/src/server.ts - Core services → Shared contracts: uses contracts
packages/assistant/src/app/core.service.ts - Core services → Account flows: supports account UI
- Home dashboard → Shared contracts: uses shared types
packages/home/src/app/App.tsx - Community widget → Developer: presents community
- Editor surface → Developer: offers editor
README.md - Account flows → Supabase auth: authenticates