How harishkotra/agent-office works
This tree contains two distinct runtime products: AgentOffice, a local-LLM multi-agent simulation, and the nested Pixel Agents VS Code extension, which visualizes and tracks coding-agent sessions. AgentOffice’s documented flow runs from the office UI through the server room to agent inference, action/tool execution, and persistent memory; its UI also exposes task and layout controls. Pixel Agents’ flow tracks terminal/transcript and hook activity into extension state and a webview office. Pixel edges follow SOURCE INDEX references and excerpts; unsampled subsystems are represented without speculative internal links.
Main entry points: OfficeRoom.ts Office room · App.tsx Browser controls · extension.ts Extension entry · agentManager.ts Agent manager
Components 30
AgentOffice Runtime
- Agent lifecycle
packages/core/src/agent/Agent.ts - Inference adapters
packages/adapters/src/OllamaAdapter.ts - Office room
packages/server/src/rooms/OfficeRoom.ts - Tool execution
packages/server/src/tools/ToolExecutor.ts - Persistent memory
packages/server/src/memory/MemoryStore.ts - Memory manager
packages/core/src/memory/MemoryManager.ts - Task management
packages/core/src/task/TaskManager.ts - Office grid
packages/core/src/office/Grid.ts
AgentOffice Interface
- Browser controls
packages/ui/src/App.tsx - Office renderer
packages/ui/src/game/Game.ts - Layout editor
packages/ui/src/components/LayoutEditor.tsx - Task board
packages/ui/src/components/TaskBoard.tsx
Pixel Agents Host
- Extension entry
pixel-agents-repo/src/extension.ts - Agent manager
pixel-agents-repo/src/agentManager.ts - Transcript watcher
pixel-agents-repo/src/fileWatcher.ts - Transcript parser
pixel-agents-repo/src/transcriptParser.ts - Activity timers
pixel-agents-repo/src/timerManager.ts
Pixel Agents Events
- Session server
pixel-agents-repo/server/src/server.ts - Provider registry
pixel-agents-repo/server/src/provider.ts - Team provider
pixel-agents-repo/server/src/teamProvider.ts - Hook event handler
pixel-agents-repo/server/src/hookEventHandler.ts
Pixel Agents Webview
- Office webview
pixel-agents-repo/webview-ui/src/App.tsx - Extension messages
pixel-agents-repo/webview-ui/src/hooks/useExtensionMessages.ts - Office simulation
pixel-agents-repo/webview-ui/src/office/engine/officeState.ts - Layout editing
pixel-agents-repo/webview-ui/src/hooks/useEditorActions.ts - Editor state
pixel-agents-repo/webview-ui/src/office/editor/editorState.ts - Furniture catalog
pixel-agents-repo/webview-ui/src/office/layout/furnitureCatalog.ts
Other components
- User
- Ollama / API
- VS Code user
Connections 30
- User → Browser controls: uses
README.md - Browser controls → Office renderer: displays
packages/ui/src/main.tsx - Browser controls → Task board: offers tasks
packages/ui/src/App.tsx - Browser controls → Layout editor: offers layout
packages/ui/src/App.tsx - Browser controls → Office room: syncs state
README.md - Office renderer → Office room: receives state
README.md - Office room → Agent lifecycle: runs agents
packages/server/src/rooms/OfficeRoom.ts - Office room → Inference adapters: requests inference
packages/server/src/rooms/OfficeRoom.ts - Inference adapters → Ollama / API: sends prompts
README.md - Office room → Tool execution: dispatches actions
packages/server/src/rooms/OfficeRoom.ts - Office room → Persistent memory: reads and writes
packages/server/src/rooms/OfficeRoom.ts - Memory manager → Persistent memory: persists recall
- Office room → Task management: manages tasks
- Office room → Office grid: updates office
- VS Code user → Extension entry: opens extension
- Extension entry → Agent manager: manages sessions
- Agent manager → Transcript watcher: starts watching
pixel-agents-repo/src/agentManager.ts - Transcript watcher → Transcript parser: parses transcripts
pixel-agents-repo/src/fileWatcher.ts - Agent manager → Activity timers: manages timers
pixel-agents-repo/src/agentManager.ts - Session server → Provider registry: loads providers
pixel-agents-repo/server/src/server.ts - Provider registry → Team provider: uses team provider
pixel-agents-repo/server/src/provider.ts - Session server → Hook event handler: routes hooks
- Hook event handler → Activity timers: controls timers
pixel-agents-repo/server/src/hookEventHandler.ts - Extension entry → Office webview: hosts view
- Office webview → Extension messages: handles messages
pixel-agents-repo/webview-ui/src/App.tsx - Extension messages → Office simulation: updates agents
pixel-agents-repo/webview-ui/src/hooks/useExtensionMessages.ts - Office webview → Layout editing: offers editing
pixel-agents-repo/webview-ui/src/App.tsx - Layout editing → Editor state: updates state
pixel-agents-repo/webview-ui/src/hooks/useEditorActions.ts - Layout editing → Furniture catalog: queries catalog
pixel-agents-repo/webview-ui/src/hooks/useEditorActions.ts - Office simulation → Furniture catalog: builds office
pixel-agents-repo/webview-ui/src/office/engine/officeState.ts