How 1181110317/agenthub works
AgentHub is a local web workspace for running coding agents and built-in model chat, then reviewing their streamed work in a shared session UI. The main path is user → browser workspace → server → agent adapter/runtime → streamed results and persisted session state. Separate branches provide workspace operations, MCP tools, remote execution, scheduled tasks, and usage/search. README documents additional capabilities whose implementation was not sampled; those are represented only where the tree supports a source path, and uncertain call wiring is omitted.
Main entry points: server.js HTTP and WS server · agents.js Agent adapters · app.js Web workspace · api-agent.js Built-in agent
Components 25
Workspace UI
- Web workspace
public/app.js
Request runtime
- HTTP and WS server
server.js - Assistant roles
lib/assistants.js - Provider presets
lib/provider-presets.js
Agent execution
- Agent adapters
lib/agents.js - Built-in agent
lib/api-agent.js - Claude bridge
lib/claude-bridge.js - Codex bridge
lib/codex-bridge.js - ZCode bridge
lib/zcode-bridge.js - ACP connector
lib/acp-agent.js - MCP tools
lib/mcp-tools.js - MCP servers
lib/mcp-servers.js
Workspace features
- SSH remote
lib/ssh.js - Workspace operations
lib/workspace.js - Git changes
lib/git.js - Scheduled tasks
lib/cron.js - Usage records
lib/usage.js - Conversation search
lib/db.js
State and access
- JSON persistence
lib/store.js - Session messages
lib/session-files.js - Turn events
lib/events.js - Web account access
lib/auth.js
Other components
- User
- Model provider
- Agent CLI
Connections 27
- User → Web workspace: uses
- Web workspace → HTTP and WS server: sends requests
- HTTP and WS server → Agent adapters: starts sessions
- Agent adapters → Built-in agent: dispatches built-in
- Agent adapters → Claude bridge: starts bridge
- Agent adapters → Codex bridge: starts bridge
- Agent adapters → ZCode bridge: starts bridge
- Agent adapters → ACP connector: dispatches ACP
- Built-in agent → Model provider: requests completions
- Claude bridge → Agent CLI: runs CLI
- Codex bridge → Agent CLI: runs CLI
- ZCode bridge → Agent CLI: runs CLI
- HTTP and WS server → MCP tools: exposes tools
- HTTP and WS server → MCP servers: manages servers
- HTTP and WS server → SSH remote: uses remote access
- HTTP and WS server → Workspace operations: handles file operations
- HTTP and WS server → Git changes: handles Git requests
- HTTP and WS server → Scheduled tasks: runs scheduled tasks
- HTTP and WS server → Usage records: records usage
- HTTP and WS server → Conversation search: queries conversation index
- HTTP and WS server → JSON persistence: persists state
- HTTP and WS server → Session messages: persists messages
- HTTP and WS server → Turn events: records turn events
- HTTP and WS server → Web account access: checks access
- HTTP and WS server → Assistant roles: loads assistant roles
- HTTP and WS server → Provider presets: serves provider presets
- HTTP and WS server → Web workspace: streams results