How godilman/agentbits works
Agentbits is a local-first desktop workspace for coordinating AI-agent teams. A user configures an organization and project, chats with its lead, and explicitly starts work; the lead delegates tasks, agents run them, and the lead reviews results. The app also provides project and personal memory, files, connections, skills, terminals, and live work views. The graph combines documented workflows with relationships visible in sampled source; unsampled UI and IPC wiring is not inferred.
Main entry points: orchestrator.ts Task orchestration · service.ts File handling · repos.ts Data repositories · App.tsx Workspace UI
Components 21
Desktop workspace
- Desktop shell
src/main/index.ts - Workspace UI
src/renderer/src/App.tsx - IPC bridge
src/main/ipc.ts - Preload API
src/preload/index.ts - Live office
src/renderer/src/features/office/engine.ts - Event broadcast
src/main/events.ts
Team coordination
- Agent organization
src/main/core/org.ts - Task orchestration
src/main/core/orchestrator.ts - Task board
src/renderer/src/features/tasks/TasksView.tsx - Lead chat
src/renderer/src/features/chat/ChatView.tsx
Agent capabilities
- Project memory
src/main/projectMemory/service.ts - Memory search
src/main/core/memory.ts - File handling
src/main/files/service.ts - Agent skills
src/main/skills/service.ts - Agent terminals
src/main/terminal/manager.ts
Local data
- SQLite database
src/main/db/index.ts - Data repositories
src/main/db/repos.ts
External integrations
- AI providers
src/main/providers - Connections
src/main/connections/service.ts - Agent apps
src/main/apps/service.ts
Other components
- User
Connections 29
- User → Workspace UI: uses
README.md - Workspace UI → Preload API: requests through
- Preload API → IPC bridge: bridges requests
- Desktop shell → IPC bridge: registers
src/main/index.ts - Desktop shell → Task orchestration: initializes
src/main/index.ts - User → Agent organization: configures
README.md - User → Lead chat: describes goal
README.md - Lead chat → Task orchestration: submits work
- Task orchestration → AI providers: runs agents with
README.md - Task orchestration → Task board: updates task work
README.md - Task orchestration → Project memory: uses
src/main/core/orchestrator.ts - Task orchestration → Connections: uses tools from
src/main/core/orchestrator.ts - Task orchestration → Agent apps: uses tools from
src/main/core/orchestrator.ts - Task orchestration → Agent skills: uses
src/main/core/orchestrator.ts - Task orchestration → File handling: uses
src/main/core/orchestrator.ts - Task orchestration → SQLite database: reads and writes
src/main/core/orchestrator.ts - Task orchestration → Event broadcast: publishes
src/main/core/orchestrator.ts - Agent organization → Data repositories: uses
src/main/core/org.ts - Data repositories → SQLite database: queries
src/main/db/repos.ts - File handling → Data repositories: uses
src/main/files/service.ts - File handling → SQLite database: stores file data
src/main/files/service.ts - Project memory → Data repositories: uses
src/main/projectMemory/service.ts - Agent terminals → Event broadcast: emits terminal events
src/main/terminal/manager.ts - Event broadcast → Workspace UI: broadcasts events
src/main/events.ts - User → Task board: tracks and reviews
README.md - User → Live office: watches agents
README.md - User → File handling: attaches files
README.md - User → Memory search: searches memories
README.md - User → Agent terminals: interacts with agents
README.md