How flow-research/garden works
Garden is a shared workspace where people and persistent AI agents coordinate chats, tasks, automations, skills, connected tools, documents, and approvals. The main user workflow is to enter the tabbed workspace, start or resume an agent chat, provide context such as files, and follow the agent’s work and approval requests. The graph covers that interaction plus the documented task, automation, knowledge, and integration capabilities. Several feature implementations were not sampled; those branches are represented at their exact feature-directory paths, with README evidence where appropriate.
Main entry points: chat-panel-controller.tsx Chat panel · runtime-mcp-controller.ts Tool controller · chat-runtime-provider.tsx Chat runtime · Brain.ts Workspace knowledge
Components 23
Workspace UI
- Garden workspace
apps/web/src/components/shell/app-shell.tsx
Agent interaction
- Chat panel
apps/web/src/features/chat/components/chat-panel-controller.tsx - Chat composer
apps/web/src/features/chat/components/chat-composer.tsx - Chat runtime
apps/web/src/features/chat/chat-runtime-provider.tsx - Agent request router
apps/web/src/server.ts - Agent skills
apps/web/src/features/skills
Team work
- Tasks and issues
apps/web/src/features/issues - Issue run service
packages/server/src/issues/run-service.ts - Automations
apps/web/src/features/automations - Automation runs
packages/server/src/automations/run-service.ts - Application database
packages/db/src/client.ts
Knowledge and documents
- Workspace knowledge
packages/brain/src/services/Brain.ts - Brain worker composition
packages/brain/src/services/worker.ts - Helix graph store
packages/brain/src/services/HelixClient.ts - File ingestion
apps/web/src/lib/server/brain-file-ingestion.ts - Chat documents
apps/web/src/features/chat/components/chat-document-panel.tsx - Document artifact engine
packages/agent-runtime/src/documents/document-artifact-engine.ts - Artifact repository
packages/agent-runtime/src/documents/document-artifact-repository.ts
Tools and governance
- Tool controller
packages/agent-runtime/src/runtime-mcp-controller.ts - Permissions and approvals
packages/core/src/agents/permissions.ts - Connected tools
packages/connectors/src/github-app.ts
Other components
- Team member
- GitHub
Connections 23
- Team member → Garden workspace: uses
README.md - Garden workspace → Chat panel: opens chat
README.md - Chat panel → Chat runtime: binds runtime
apps/web/src/features/chat/components/chat-panel-controller.tsx - Chat panel → Chat composer: renders
apps/web/src/features/chat/components/chat-panel-controller.tsx - Chat composer → Chat runtime: sends turns
apps/web/src/features/chat/components/chat-composer.tsx - Chat runtime → Agent request router: connects agent
- Agent request router → Tool controller: routes agent requests
apps/web/src/server.ts - Tool controller → Permissions and approvals: checks trust
packages/agent-runtime/src/runtime-mcp-controller.ts - Tool controller → Connected tools: resolves tools
packages/agent-runtime/src/runtime-mcp-controller.ts - Connected tools → GitHub: integrates
README.md - Team member → Tasks and issues: tracks work
README.md - Tasks and issues → Issue run service: starts issue run
- Issue run service → Application database: persists issues
packages/server/src/issues/run-service.ts - Team member → Automations: configures runs
README.md - Automations → Automation runs: schedules work
README.md - Team member → Agent skills: manages skills
README.md - Team member → Workspace knowledge: uses workspace knowledge
README.md - File ingestion → Workspace knowledge: ingests files
apps/web/src/lib/server/brain-file-ingestion.ts - Brain worker composition → Workspace knowledge: composes services
packages/brain/src/services/worker.ts - Brain worker composition → Helix graph store: configures client
packages/brain/src/services/worker.ts - Team member → Chat documents: attaches documents
README.md - Chat documents → Document artifact engine: edits artifacts
- Document artifact engine → Artifact repository: transacts snapshots
packages/agent-runtime/src/documents/document-artifact-engine.ts